www.IHeartTechnicalWriting.com

              Kate Winslet’s 7 Ways to Checking
                    Technical Documents


...
www.IHeartTechnicalWriting.com
   2. Tasks - Does your user guide address the user’s requirements? Check the document to s...
Upcoming SlideShare
Loading in …5
×

Kate winslet’s 7 ways to checking technical documents

551 views

Published on

What can Kate Winslet teach you about proof-reading technical documents? Watch the movie The Reader and it will make sense. If she was writing this blog, she’d probably say: “Don’t do it all at once! One of the biggest mistakes you can make when revising any technical document, is to do it all in one go. You can’t!” And she’d be right.

Published in: Business, Technology
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total views
551
On SlideShare
0
From Embeds
0
Number of Embeds
8
Actions
Shares
0
Downloads
4
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

Kate winslet’s 7 ways to checking technical documents

  1. 1. www.IHeartTechnicalWriting.com Kate Winslet’s 7 Ways to Checking Technical Documents Click to view large Post by Ivan Walsh. Follow me on Twitter. What can Kate Winslet teach you about proof-reading technical documents? Watch the movie The Reader and it will make sense. If she was writing this blog, she’d probably say: “Don’t do it all at once! One of the biggest mistakes you can make when revising any technical document, is to do it all in one go. You can’t!” And she’d be right. 7 Secret Ways to Revise Technical Documents Make it easy on yourself and focus on one area at a time. Instead of revising the document in one session, break out the tasks and revise the document by task. For example, start with checking the facts, then the spelling, how the document flows, cross-references, footers, index entries and so on. Seven Ways to Revise Technical Documents. 1. Overview - In the opening section, do you have a statement, a sentence or two that states the main point or argument of your document? Likewise, is there a conclusion that ties together all the points made in your document? Page 1 of 2 http://www.ihearttechnicalwriting.com/
  2. 2. www.IHeartTechnicalWriting.com 2. Tasks - Does your user guide address the user’s requirements? Check the document to see if you addressed each task and provided enough information for the user to perform the task. 3. Structure - Does the document flow? Make sure each topic connects clearly and logically. Do the topic sentences of each paragraph relate to the subject matter? 4. Accuracy - Is the information correct? Is it adequately documented? Have you tested the document so that it helps the reader to perform their tasks? 5. Language - Do you use specific language? Avoid vague terms such as in the event of, thing, factors, and over reliance on unclear pronouns like "this" and "it." 6. Drafts – Technical Writing involves writing multiple drafts. This means that after each draft, you need to check that the edits have been included in the correct draft. 7. Read Aloud – Get into the habit of reading your documents aloud. If you have trouble reading a sentence clearly and smoothly, it probably needs to be rewritten. And if it sounds wrong to your ear, then that’s a warning sign that something needs to be corrected. PS - I also use a checklist to check off the different tasks as I revise technical document. This is especially helpful if you’re working late or are revising several documents in succession. One mistake to avoid is to focus on one area, for example spelling, and overlook other areas, for example, the accuracy of the material. While the reader may forgive you for the occasional spelling mistake, they won't be impressed if the material itself is incorrect. How do you revise your documents? What mistakes do you see most often? About the Author: Ivan Walsh is a technical writer with a weakness for documentation plan guides. His also runs a video marketing blog at www.videocameraschool.com Page 2 of 2 http://www.ihearttechnicalwriting.com/

×