Re: Coding documentation?

Subject: Re: Coding documentation?
From: Laura Lemay <lemay -at- lauralemay -dot- com>
To: Hannah Drake <hannah -at- formulatrix -dot- com>
Date: Thu, 5 Dec 2013 11:00:03 -0800


I'm curious why the product part numbers won't work for your docs. When I was still at an org that had part numbers, we used the product number + code indicating documentation + doc revision number, eg SKU123456-DOC-001. You could replace doc revision number with the date or some other useful indicator.

That said if you're doing iterative documentation in wikis for iterative products that don't have actual "releases" then it makes much more sense to go by dates and times rather than try to back-fit part numbers to a situation that doesn't really call for it.

Laura

On Dec 4, 2013, at 11:17 AM, Hannah Drake wrote:

> Hi TechWrl Family,
>
> (I'm loving this list by the way) -- Now that my company has started to
> grow a library of professional documentation, someone suggested assigning
> part numbers to the documentation instead of just the date it was released.
> But, the convention they use for our part numbers doesn't quite work for
> documentation.
>
> What numbering conventions can you suggest? Right now I just keep the
> latest version of something on our Google wiki, which has a version
> history, so that sort of works. But I feel like it would look more polished
> if we started using some fancy, "no idea what that number means --
> QT75729A2 is so mysterious" numbering system.
>
> --
> Hannah L. Drake
>
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> New! Doc-to-Help 2013 features the industry's first HTML5 editor for authoring.
>
> Learn more: http://bit.ly/ZeOZeQ
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> You are currently subscribed to TECHWR-L as lemay -at- lauralemay -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



^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
New! Doc-to-Help 2013 features the industry's first HTML5 editor for authoring.

Learn more: http://bit.ly/ZeOZeQ

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

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:
Coding documentation?: From: Hannah Drake

Previous by Author: Re: best current books for teaching tech writing?
Next by Author: SUMMARY: Re: best current books for teaching tech writing?
Previous by Thread: RE: Spam: Re: Coding documentation?
Next by Thread: Re: Coding documentation?


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


Sponsored Ads