Most Influential Techcomm

SoftXML - Experience the power of xml-based websites from the experts.

Every Page is Page One

Cover of Every Page is Page One, linked to larger image
Every Page is Page One: Topic-based Writing for Technical Communication and the Web
by Mark Baker. $29.95 (print), 23.95 (ebook).

Buy now on Amazon.com

Buy now at Barnes & Noble

Buy Ebook now at O’Reilly eBookstore

The Web changes how people use content; not just content on the Web, but all content. If your content is not easy to find and immediately helpful, readers will move on almost at once. We are all children of the Web, and we come to any information system, including product documentation, looking for the search box and expecting every search to work like Google. There is no first, last, previous, next, up, or back anymore. Every Page is Page One.

For technical communicators, this Every Page is Page One environment presents a unique challenge: How do you cover a large and complex product using only topics, and how do you enable your readers to find and navigate topic-based content effectively?

In this ground-breaking book, Mark Baker looks beyond the usual advice on writing for the Web, and beyond the idea of topic-based writing merely as an aid to efficiency and reuse, to explore how readers really use information in the age of the Web and to lay out an approach to planning, creating, managing, and organizing topic-based documentation that really works for the reader.

Inside the Book

Here is a compact version of the outline. For a full, annotated version, go to Mark’s blog: http://everypageispageone.com.

  • Foreword by Scott Abel
  • Preface: In the Context of the Web
  • Part I: Content in the Context of the Web
    • Include it all. Filter it afterward.
    • The Distributed Nature of Content on the Web
    • Information Architecture Top Down
    • Information Architecture Bottom Up
  • Part II: Characteristics of Every Page is Page One topics
    • What is a Topic?
    • EPPO Topics are Self-contained
    • EPPO Topics have a Specific and Limited Purpose
    • EPPO Topics Conform to a Type
    • EPPO Topics Establish their Context
    • EPPO Topics Assume the Reader is Qualified
    • EPPO Topics Stay on One Level
    • EPPO Topics Are the Narrative Minim
    • EPPO Topics Link Richly
  • Part III: Writing Every Page is Page One Topics
    • Writing Every Page is Page One Topics
    • Every Page is Page One Topics and the Big Picture
    • Sequence of Tasks vs. Sequence of Topics
    • EPPO and Minimalism
    • Structured Writing
    • Metadata
    • Linking
    • Reuse
  • Making the Case for Every Page is Page One
  • Afterword: EPPO, but Not for Everything
  • Glossary
  • Bibliography
  • Index

About the Author

Mark Baker is Principal Consultant for Analecta Communications, Inc. (analecta.com) a content strategy and structured writing company located in Ottawa, Canada. He has been practicing and implementing structured writing since the SGML days, and gave his first paper on topic-based authoring at SGML 95, under the title “Component Based Information Development.”

His previous positions include Manager of Information Engineering Methods at Nortel and Director of Communications for SGML pioneer OmniMark Technologies. He blogs on topic-based authoring at everypageispageone.com. He is also the creator of the SPFE (“spiffy”) architecture for structured authoring and publishing, which is described at SPFE.info. He tweets as @mbakeranalecta.