Recently, O’Reilly Media released a new book by Tim O’Reilly and Sarah Milstein: The Twitter Book. A review of the book will be coming in the next couple of weeks.
What’s interesting about the book isn’t its subject matter, but rather the way in which it was written. Believe it or not, the book was done in PowerPoint. Yes, PowerPoint. A piece of software that’s generally used to create presentation slides.
Shortly after the book’s release, Tim O’Reilly recently blogged about the book, the writing process, and how the approach to the The Twitter Book was an attempt to reinvent the concept of the book in the age of the Web. Read O’Reilly’s post for the details.
A lot, believe it or not. Each page is self contained. In most cases, you don’t need to read other pages of the book in order for that page to make sense. This approach is very similar to a concept with which you might be familiar: topic-based writing.
As Mike Hamilton of MadCap Software said in a session he did at DocTrain East 2008, a topic is a standalone piece of content. It doesn’t rely on information from any other piece of content in a book or manual or help system. Or anything else for that matter. That’s the approach O’Reilly and Milstein took, whether they realized it or not.
While Tim O’Reilly described how The Twitter Book was created as being a different approach to publishing, it’s also a different approach to writing. In a scenario like this, you need to pack a lot of information on to a single page. The space constraints force you to write very tightly. You need to contain an idea or a concept within the alloted space.
On top of that, the type and spacing are probably larger in this kind of layout — paragraphs are probably not going to be 12 point Garamond, single spaced. This means even fewer words.
A book like The Twitter Book is also very visual. You need to work text around the visuals; everything has to blend together. Which isn’t easy.
If you’re self publishing, then you have to be a good visual designer. Or, that the very least, have a good grasp of the concepts of design. Or, you need to engage a designer.
Doing what O’Reilly and Milstein did with The Twitter Book is definitely a lot of work. In addition to the design, doing something like this requires:
One more point: the content must be both relevant and usable. Wrapping fluff in pretty imagery just doesn’t cut it. And it does your readers a disservice.
If you haven’t already guessed, I can see this concept being applied to documentation. I’m not saying that you should ditch your favourite tool for PowerPoint. But using what you have — whether it’s FrameMaker, Blaze, InDesign, Scribus, or even a presentation app — you can adapt the techniques and ideas behind The Twitter Book to documentation.
Admittedly, not all documentation. This approach is great for quick reference guides or visual references for a set of features of an application.
I’m not sure that this approach will work in all cases, but it’s definitely worth considering.
Thoughts? Feel free to leave a comment.
Related posts:
4 Responses
Anne Gentle
May 15th, 2009 at 10:39 pm
1You know, at dinner one of the nights of the STC Summit we talked about how Twitter posts are good practice for writing DITA elements which stands for short description – a summary of the topic in five words or less is the typical goal. Those short descriptions are used for tooltips on links to the topic, or in search summaries, or in an advanced organizer. Very handy, they are. Not to bring everything back around to DITA, but it does seem like Twittering is good practice for elegant and simple communication!
I am getting a copy of The Twitter book – Andy Oram wrote the foreword for my upcoming book, and he immediately saw a tie-in there. It’s in the Recommended Reading section for my Conversation and Community book.
Scott
May 16th, 2009 at 2:17 pm
2Anne,
Good points. Twitter is a good exercise in writing tightly. Come to think of it, writing tweets (or dents or whatever they’re called on the microblogging platform someone uses) is good practice for writing error messages. Just tweeted about that …
Eddie VanArsdall
May 19th, 2009 at 5:07 pm
3Hey, Scott and Anne,
Thanks to Scott’s post, I just downloaded the Twitter book. I have already read the introduction and am intrigued with the way the book has been written and presented.
With Web technologies changing and evolving so rapidly, the concept of “book publishing” is obviously undergoing its own transformation. I look forward to observing and participating.
Scott
July 8th, 2009 at 10:30 pm
4@Eddie
You’re the third or fourth person who bought the book based on my mentioning it. I wonder if O’Reilly will give me finder’s fee?
RSS feed for comments on this post · TrackBack URI
Leave a reply
Blogroll
Past Entries