Re: Document Revision History - Front or Back of the Doc?

Subject: Re: Document Revision History - Front or Back of the Doc?
From: Keith Hood <klhra -at- yahoo -dot- com>
To: Ron Hearn <rhearn -at- central1 -dot- com>, "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 20 Jul 2012 23:53:35 -0700 (PDT)

My take is, why bother having it at all? Why, really, would anyone care how many changes the doc has gone through, and exactly what changes have been made? What does a revision history tell the reader beyond the fact that you didn't get it right the first time?


What a reader wants to know most of all is that the doc is complete and accurate NOW. Having a long document history is contraindicated if you really want customer confidence. I figure the longer your revision history, the more likely people are to wonder why did you make so many mistakes and why did you have to go through so many redesigns to get it right? And the more entries there are in the revision history, the more likely they are to wonder if you really *have* finally gotten it right.



________________________________
From: Ron Hearn <rhearn -at- central1 -dot- com>
To: "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Sent: Tuesday, July 17, 2012 12:52 PM
Subject: Document Revision History - Front or Back of the Doc?

Hi folks,

I have been placing the document revision history for a document as part of the preface in my documentation. Someone suggested that it should be located at the end of the document.  I am just wondering where other TWs place this part of the document.

Regards,

Ron Hearn
Documentation Specialist

Central 1 Credit Union
1441 Creekside Drive
Vancouver, British Columbia, Canada
V6J 4S7

rhearn -at- central1 -dot- com<mailto:rhearn -at- central1 -dot- com>
Tel: 604.730.6391
Fax: 604.730-7792
www.central1.com/thinkingforward<http://www.central1.com/thinkingforward>




^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help. Choose your authoring formats and get any output you may need.

Try Doc-To-Help, now with MS SharePoint integration, free for 30-days.

http://bit.ly/doc-to-help

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as klhra -at- yahoo -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications?  Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions?  Search our public email archives @ http://techwr-l.com/archives

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help. Choose your authoring formats and get any output you may need.

Try Doc-To-Help, now with MS SharePoint integration, free for 30-days.

http://bit.ly/doc-to-help

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


Follow-Ups:

References:
Document Revision History - Front or Back of the Doc?: From: Ron Hearn

Previous by Author: Re: Careers For People Who Don't Like People
Next by Author: Re: Document Revision History - Front or Back of the Doc?
Previous by Thread: Re: Document Revision History - Front or Back of the Doc?
Next by Thread: Re: Document Revision History - Front or Back of the Doc?


What this post helpful? Share it with friends and colleagues:

Sponsored Ads


Sponsored Ads