Gary and Bob are technical writers assigned to write a product manual for their company. Gary follows best practices like consulting subject matter experts on terminology, understanding the audience, and adhering to style guides. Bob does not fully follow these practices. Their writing needs to be easily translated. The presentation discusses how to be a good writer through setting style standards, automating consistency, and understanding audiences and goals. The Congree software allows maintaining consistency across documents.
Yaroslav Rozhankivskyy: Три складові і три передумови максимальної продуктивн...
"What Makes a Good Writer Good, and a Bad Writer Bad?"
1. And a Bad Writer Bad? What Makes a Good Writer Good? Presented by Congree, Inc. June 29, 2011 Glendale, CA
2. Outline Meeting the Characters and Setting the Stage Understanding the Challenges Locking in Good Writing Habits Avoiding Bad Habits Conceptualizing Standards and Practices Implementing Standards and Practices (Congree Demo) Questions and Answers
3. The Writers: Gary is a Good Writer – he keeps to standards and practices that make his writing valuable to his employers and clear for his audience. Bob is a Bad Writer – he doesn’t know what makes writing good, or just doesn’t care. Bob could use some improvement.
4. The Challenge: Gary and Bob are each assigned half of the technical writing work on an important product manual for their company. Their boss expects it to be done quickly, efficiently, and clearly.
5. The Twist: Que? Gary and Bob also need to take into account that the manual will be translated into Spanish by the company’s localization team – this means their writing has to be as amenable to translation as possible.
6. Getting Started: Gary always follows a few basic principles before he starts writing: He speaks to the engineers to understand the terms he’ll need to use. He speaks to his marketing people to understand the audience that will be reading the manual. He consults his corporate style guide to ensure he knows the proper phrasing and punctuation, etc. He subordinates the uniqueness of his own writing style to ensuring consistency in the text that he (and others) is writing. Gary chooses the proper editor for the job, given his options.
7. Getting Started (wrong): Bob follows a similar process to Gary, but omits several key items: Bob checks his terminology guide, but doesn’t consult the terms team. Bob understands his assignment, but doesn’t understand for whom the assignment is ultimately destined. Bob uses the editor he’s familiar with, even if it’s not the best choice for the job. Bob never considers that his work is going to need to be translated, and instead focuses on writing in the ways that he was trained.
8. Which Text Editor Should You Use? ? Editors are generally a matter of personal preference, but ensure that the tool you want to use is the right one for your particular area.
9. Know Your Audience Remember that all technical writing does not need to be “technical,” nor does it need to be complex. Ask yourself: Who is going to read this manual – both drafts, and after release? What is the goal that I’m trying to get across with every section I write? Don’t treat them as if they’re like this: If your readers are more like this:
10. Know the Style Guide: Does your company have an official style guide, or do you use a pre-fab one? Is it modified? Understand the rules of the style guide, but know when to bend them for the sake of clarity and consistency. If you don’t have a style guide, consult with all the other writers and editors on the project to ensure you’re all coming from the same place. Always think about “tone.” Take into account outside issues, such as the need to make text amenable to translation, when developing and implementing style guides.
11. Automate Consistency to Increase Creativity When we write in any context, we want to inject the text with our own voice – and that’s good! However, too often our own unique writing style leads to inconsistencies in the tone, terminology, style, or diction of a text – and that’s bad! We can remain creative and unique, yet still maintain consistency in our text by ensuring we stick to style guides, and by ensuring we automate the processes by which we structure our documents.
12.
13.
14. Wrap Up Remember: Maximize consistency through software tools. Implement style guides easily and automatically. Take into account your audience, both within and without. Understand the proper terms, and the right text editor, for the job. Gary Bob