Social Rules for Creating a Style Guide
Creating a style guide may initially seem like a terminology affair (“option button” or “radio button” – pick one), but the real challenge lies in persuading the department to adopt new style...
View ArticleManaging Edits for an Online Help Monster
As a technical writer developing large online help projects, I faced challenges in managing the editing process–specifically, ensuring consistency across each of the help files and controlling versions...
View ArticleDeveloping a Departmental Style Guide
Editor’s Note: The following piece, by Jean Hollis Weber, is part of our collection of “classics”–articles that stand the test of time no matter how many technologies come and go. Don’t forget to...
View ArticleThe Perfect Tech Writer’s Letter to Santa
Cheryl Voloshin doesn’t want anything more than peace, love and understanding for the holidays, but as they say, “the devil’s in the details.” Dear Santa, First, let me thank you in advance for what...
View ArticleCreate Technical Writing Consistency While You Write—Or Add it Later
Tech Writer Today’s The Users’ Advocate column is brought to you by Adobe Systems, Inc. Download a 30-day free trial of Adobe FrameMaker here. One of the primary tasks any writer or editor must...
View ArticleA Friendlier, Breezier and Technical Writing Style Reference
Review of the Microsoft Manual of Style (MMOS) 4th Edition Introduction One thing caught my eye right away with the Fourth Edition of the “Microsoft Manual of Style: Your everyday guide to usage,...
View ArticleDear Santa: Five Wishes Before We Just Hang Out
Dear Santa, I know you suffer because so few people believe in you, even though you deliver as much and often as you can, even though you deliver, on time, except for when hucksters pretending to be...
View Article
More Pages to Explore .....