Log In
Or create an account ->
Imperial Library
Home
About
News
Upload
Forum
Help
Login/SignUp
Index
Every Page is Page One
Foreword
Preface: In the Context of the Web
1. Audience
2. Discussion
3. Acknowledgments
1. Introduction
1.1. Every page is page one
1.2. Why do we still write books?
1.3. About the book
I. Content in the Context of the Web
2. Include it all. Filter it afterward.
2.1. Just Google it
2.2. The long tail
2.3. Authority and experience
2.4. Aggregation and curation
2.5. Filter it afterward
3. The Distributed Nature of Content on the Web
3.1. How we use the Web
3.2. Dynamic semantic clustering
4. Information Architecture Top Down
4.1. Book navigation
4.2. The trouble with TOCs
4.3. Curriculum versus classification
4.4. The limits of hierarchies
4.5. The cultural bias toward hierarchies
4.6. The rise of the Frankenbooks
4.7. Faceted navigation
4.8. The limits of classification
4.9. Where top-down works
5. Information Architecture Bottom Up
5.1. A web of subject affinities
5.2. Irregular subject affinities
5.3. Subject affinities are not citations
5.4. Topics as hubs
5.5. The flattening problem
5.6. Broader, deeper, more dynamic
5.7. Should we abandon top-down navigation?
5.8. The role of lists
II. Characteristics of Every Page is Page One Topics
6. What is a Topic?
6.1. Building-block topics
6.2. Presentational topics
6.3. Every Page is Page One topics
6.4. Economics and the evolution of topics
6.5. DITA and Information Mapping
6.6. Topics and the Web
6.7. Every page is still page one even if the reader reads several
6.8. Characteristics of EPPO topics
7. EPPO Topics are Self-contained
7.1. Self-contained, not all alone
7.2. The information scent of self-contained topics
8. EPPO Topics have a Specific and Limited Purpose
8.1. The scope of a topic
8.2. Task-based writing
8.3. Derived purpose
8.4. Defining the purpose of a topic
8.5. Topic purpose vs. user purpose
8.6. Purpose and topic size
8.7. Decision support and the reader’s purpose
8.8. Purpose and findability
9. EPPO Topics Conform to a Type
9.1. The evolution of topic types
9.2. Discovering and defining topic types
9.2.1. Discovering topic types
9.2.2. Defining topic types
9.2.3. Handling optional material
9.2.4. Serving the commercial purpose
9.3. Concept, task, and reference reconsidered
9.3.1. The origins of concept, task, and reference
9.3.2. A task is not a procedure
9.3.3. A reference is more than a topic
9.3.4. Everything else is not a concept
10. EPPO Topics Establish their Context
10.1. Establishing context
10.2. Context and the imprecision of search
11. EPPO Topics Assume the Reader is Qualified
11.1. Reader dependencies vs. subject dependencies
11.2. Determining the qualified reader
11.3. Choosing the level of understanding
11.4. Avoid arbitrary labels
11.5. Qualification and findability
12. EPPO Topics Stay on One Level
12.1. Books change levels at the author’s fiat
12.2. Keeping topics on one level
13. EPPO Topics Link Richly
13.1. Links and the democratization of knowledge
13.2. Linking and findability
III. Writing Every Page is Page One Topics
14. Writing Every Page is Page One Topics
14.1. Textbooks vs. user assistance
14.2. Writing topics
14.2.1. Topics are self-contained
14.2.2. Topics have a specific and limited purpose
14.2.3. Topics conform to a type
14.2.4. Topics establish their context
14.2.5. Topics assume the reader is qualified
14.2.6. Topics stay on one level
14.2.7. Topics link richly
14.3. The question of style
14.4. Concerning reference information
14.5. Concerning tutorials
14.6. Concerning videos
14.6.1. Videos and linking
14.6.2. Videos as topics
14.6.3. Videos as objects
15. Every Page is Page One Topics and the Big Picture
15.1. Books and the big picture
15.2. The priority of the big picture
15.3. Writing the big-picture topic
15.4. Finding the end of the string
15.5. Pathfinder topics
16. Sequence of Tasks vs. Sequence of Topics
16.1. Working backwards
17. EPPO and Minimalism
17.1. EPPO as a platform for minimalism
17.2. Is EPPO minimalist?
17.3. Minimal vs. comprehensive
18. Structured Writing
18.1. The varieties of structured writing
18.1.1. Rhetorically structured writing
18.1.2. Computably structured writing
18.1.3. A word about SPFE
18.1.4. Other forms of computable structure
18.1.5. Open and closed formats
18.1.6. The varieties of computable structures
18.2. Benefits of computably structured writing
18.2.1. Improved content quality
18.2.2. Guidance for writers
18.2.3. Conformance and quality
18.2.4. Linking
18.2.5. Content manipulation
18.2.6. Future proofing
18.2.7. Single sourcing
18.2.8. Reuse
18.2.9. Content exchange
18.3. Structured writing and bottom-up organization
19. Metadata
19.1. The meaning of metadata
19.2. Topics should merit their metadata
19.3. Metadata comes first
20. Linking
20.1. Crowdsourced links
20.2. Soft linking based on subject affinities
20.2.1. Soft linking is not indirection
20.3. Soft linking and list generation
21. Reuse
21.1. Reuse on the Web
21.2. Static vs. dynamic reuse
21.3. Other forms of reuse
21.4. Reuse, linking, and interactive pages
22. Making the Case for Every Page is Page One
22.1. EPPO and resource constraints
22.2. EPPO and continuous delivery
22.3. EPPO and content change
22.4. EPPO and content aging
22.5. EPPO and agile methodologies
22.6. EPPO and content management
22.7. EPPO and PDF/help
22.8. EPPO and content marketing
22.9. EPPO and DITA
22.10. EPPO and wikis
22.11. Making the case for technical communication on the Web
22.11.1. Competitors will steal our ideas
22.11.2. Our users prefer PDF
22.11.3. No one reads the documentation anyway
23. Afterword: EPPO, but Not for Everything
Glossary
Bibliography
Index
Colophon
A. Copyright and Legal Notices
← Prev
Back
Next →
← Prev
Back
Next →