File Size: 2736 KB
Print Length: 290 pages
Publisher: XML Press; 1 edition (December 3, 2013)
Publication Date: November 26, 2013
Sold by: Digital Services LLC
Language: English
ASIN: B00GXMTX70
Text-to-Speech: Enabled
X-Ray: Not Enabled
Word Wise: Not Enabled
Lending: Not Enabled
Enhanced Typesetting: Not Enabled
Best Sellers Rank: #241,597 Paid in Kindle Store (See Top 100 Paid in Kindle Store) #32 in Books > Computers & Technology > Web Development & Design > Content Management #42 in Kindle Store > Kindle eBooks > Reference > Writing, Research & Publishing Guides > Technical #161 in Books > Reference > Writing, Research & Publishing Guides > Writing > Technical
For someone like me, who is just breaking ground into this beautiful profession, reading “Every Page is Page One” book has been an extraordinarily rich and revealing experience. The fact that my copy is full of annotations and more than 30 pages of notes is a confirmation of this.Because of my dual role as a database specialist and technical writer, I know Microsoft SQL Server documentation very well, but it was not after reading this book that I realized why this documentation is so well structured and comprehensive, and why this type of writing is a pattern to follow. The same can be said about Wikipedia, which is an example used in several chapters. This book provides a compelling argument against traditional books or book-style user guides and manuals, and explains the fundamentals to write documentation your users and customers will find -finally- useful. Isn’t this exciting enough?The only thing I missed was more examples. If you open the book this may seem contradictory, because it has plenty of examples and metaphors that makes the explanation easy to follow (I particularly liked the “recipe” example), but I am referring here to examples using “real” technical documents. In this way, I think it would be great to have some examples about how a chapter from one “traditional” manual can be rewritten in an "EPPO way”, or how DITA and EPPO can both work together in a topic. Yes, I know after reading the book this is not as simple as it sounds! :)Overall, this is an excellent book, well thought and well researched, and plenty of fresh ideas in a field that is particularly stagnant and, in most of the cases, lacks innovation.
“”This foraging behavior is not exclusive to the Web, of course. John Carroll saw the same behavior in his research subjects using paper manuals. Learners also often skip over crucial material if it does not address their current task-oriented concerns or skip around among several manuals, composing their own ersatz instructional procedures on the fly. —The Nurnberg Funnel[8, p. 8]””This quote is taken from the introduction to Chapter 1 in the book, “Every Page is Page One”. How apt it is! I do this very thing and skim through a manual trying to find how to do a particular task, and get frustrated when it isn’t there. Then I have to go back and read it again to find what I missed. Of course, many times what I’m looking for isn’t there anyway, but until I do read it I don’t know that. Either scenario is frustrating. Even on the web, sometimes I find it incredibly hard to find something on the website that I’m looking for.I have learned from this book, and one of the most important thing is to make sure people can find the information I’m writing about by treating each page as if it is page one. I suppose I never stopped to think that deeply about it. But then it’s rather hard to have each important point to be the first sentence. However, I can make use of white space and create snippets to the side of the documents which will tend to hi-light information, similar to how the book is written.If you write technical manuals, either hard copy or web copy, this book can really help you. It helps by giving you a ‘window’ into how your readers use the material. I skim, even when I search for something, but then I click on a link and I skim again, when not finding it, I will slow down and actually search for the word on the page.
Every Page is Page One Cooking for One: 365 Recipes For One, Quick and Easy Recipes (Healthy Cooking for One, Easy Cooking for One, One Pot, One Pan) Piano & Keyboard Chords: Easy-to-Use, Easy-to-Carry, One Chord on Every Page How to Boil an Egg: Poach One, Scramble One, Fry One, Bake One, Steam One How to Create and Manage a Facebook Page: Creating and Managing a Facebook Page Bettie Page: The Lingerie Edition: Classic Photographs in Full Color and Black & White (Classic Bettie Page Book 1) The Amazing Page: 650 Scrapbook Page Ideas, Tips and Techniques (Memory Makers) Tangled Up In Tuesday: (Book 4 in the Page Turners Cozy Mystery Humorous Womens Fiction Romance Series) (A Page Turners Novel) First Grade Page Per Day: Math Skills (Sylvan Page Per Day Series, Math) Every Man's Marriage: An Every Man's Guide to Winning the Heart of a Woman (The Every Man Series) The Complete Cook's Country TV Show Cookbook Season 8: Every Recipe, Every Ingredient Testing, Every Equipment Rating from the Hit TV Show Every Man's Battle: Winning the War on Sexual Temptation One Victory at a Time (The Every Man Series) The Iain Rob Wright Collection (Books 1 - 5): Fear on Every Page VINTAGE AUTOMOBILE ADVERTISING 5: 1957-1959: OVER 420 FULL SIZE VINTAGE AUTOMOBILE ADS FROM MAGAZINES AND NEWSPAPERS - LARGE ONE-AD-PER-PAGE FORMAT VINTAGE AUTOMOBILE ADVERTISING 3: 1953-1954: OVER 330 FULL SIZE VINTAGE AUTOMOBILE ADS FROM MAGAZINES AND NEWSPAPERS - LARGE ONE-AD-PER-PAGE FORMAT VINTAGE AUTOMOBILE ADVERTISING 7: 1970-1972: OVER 420 FULL SIZE VINTAGE AUTOMOBILE ADS FROM MAGAZINES AND NEWSPAPERS - LARGE ONE-AD-PER-PAGE FORMAT VINTAGE AUTOMOBILE ADVERTISING 4: 1955-1956: OVER 375 FULL SIZE VINTAGE AUTOMOBILE ADS FROM MAGAZINES AND NEWSPAPERS - LARGE ONE-AD-PER-PAGE FORMAT Every Young Man's Battle: Strategies for Victory in the Real World of Sexual Temptation (The Every Man Series) Every Woman's Battle: Discovering God's Plan for Sexual and Emotional Fulfillment (The Every Man Series) Vertical Church: What Every Heart Longs for. What Every Church Can Be.