Software Business

Sign up | Login | (650) 943 - 2447 Languages Languages
Support | Contact | Blog | Search

Writing Good Software Documentation

After Finishing Your Document

(page 3 of 3)
Published on: November 16, 2006

  • Proofreading

  • Go over the document once or twice, to make sure that the grammar you used is accurate, that you have spelled the words right, that you haven't skipped any important information and that you have formatted all your text properly.

  • Insert the Table of Contents

  • Once you're sure that your text is OK, insert the table of contents. It is preferable that it has no more than 3 - 4 levels, but this depends on what you deem important and how obvious you want some information to be to your readers.

  • Insert the Indexes

  • It is now time to index the most important terms and phrases in your document. Remember to update the table of contents afterwards.

  • Send the Document to be Reviewed

  • After checking that everything is in order, table of contents, indexes and text altogether, send the document to one of the Subject Matter Experts (SME) for review. Ask that they use the Track Changes function, so that you can see exactly what they have modified and where you should concentrate your attention.

    After you receive it back, you either have to go over some of the above-mentioned steps in order to correct possible errors or fill in some information gaps, or the document will be approved and you can forward it to the proper department so that it can be distributed to customers, and you can start working on the next document.

    * * * * * * * * * * * * * * * * * * * * *

    All in all, it is important to always keep in mind that communication is a key factor in the work of a technical writer. Communication with the technical writing team (where it exists), with the engineers, with the SMEs, with the deployment staff, the marketing staff, sometimes even with the programmers. This is the only way that a technical writer within a company can progress and evolve into a real professional.

    Rate article


    Comments (2)
    Neha says:
    July 15th, 2008 at 9:19 am

    I deem its a great article. Helped me quite alot.


    Prabu R says:
    March 16th, 2009 at 8:13 pm

    Quite an awesome resource. Helped me put together a checklist. Thank you, folks!


    Leave a comment

    Name *
    Mail(will not be published) *
    Website *
    Subscribe to comments:
    Validation Code *:       
    Please note: Comment moderation is enabled and may delay your comment. There is no need to resubmit your comment.

    Copyright ® 2009, http://www.avangate.com all rights reserved.
    This article may be reproduced in a website, e-zine, CD-ROM, book, magazine, etc. so long as the above information is included in full, including the link back to this website. Please e-mail at articles@avangate.com , before using the article.