O'Reilly logo

Every Page is Page One by Mark Baker

Stay ahead with the world's most comprehensive technology and business learning platform.

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, tutorials, and more.

Start Free Trial

No credit card required

14.2. Writing topics

Readers decide when and in what order they will read your topics. And their reading will be interspersed with other activities, including reading other people’s content. And readers will read your topics individually, not as parts of a documentation set. Therefore, the right way to write topics is one at a time. Of course, documentation managers must take a broader view, but as a writer, you should try to write one topic at a time, focusing on the topic you are writing and its specific and limited purpose. The best way to do this is to focus on the characteristics of Every Page is Page One topics, which we covered in Part II, “Characteristics of Every Page is Page One Topics”. Let’s look at how each of these characteristics ...

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, interactive tutorials, and more.

Start Free Trial

No credit card required