Re: Visual SourceSafe for Documentation Source Control

Subject: Re: Visual SourceSafe for Documentation Source Control
From: kjng -at- gprotechnologies -dot- com
To: "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 25 Oct 2005 05:06:04 -0600



Currently I am involved in implementing and documenting a CMMI Quality
Management System (lots of process docs, forms and templates, XLS & DOC).
As tech writer I also continue to develop our help manuals in ROBOHELP
2002,now X5 with VSS integration.

I am currently put our CMMI docs on public file server, and version
control was pretty adhoc, no visual source safe. We have subfolders,
Baseline, Archive and Working. Because it was not controlled by any tool,
relying on my own and team members compliance to procedure, we had our own
'configuration management' issues. Fortunately i was mostly the one
editing it, during inception. But other people ie product managers do
require copies of the templates or forms from time to time. (and this
happened sometimes when I was editing some of the docs), end result
different ppl starting work from different versions of templates and
forms.

See also: Managing Online Help Monster article on the tech writer list for
ideas.

Lesson: In future, it might serve us well, to add all these templates,
process docs and forms into VSS(currently used by developers only and me
for help docs). But that means excluding other non development members in
the org. In retro, with added CMMI knowledge, it also might automate some
of the revision history tracking and control issues with Word, template
docs.It probably still isn't as well implemented.

Currently my help project development is integrated directly into VSS.
Haven't had to recover any topics or pages so far, but i guess i do have
peace of mind that its backed up automatically and different versions of
it are retrievable if i need it.

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

Try WebWorks ePublisher Pro for Word today! Smooth migration of legacy
RoboHelp content into your new Help systems. EContent Magazine Decision-
maker review (October 2005) is here: http://www.webworks.com/techwr-l

Doc-To-Help 2005 converts RoboHelp files with one click. Author with Word or any HTML editor. Visit our site to see a conversion demo movie and learn more. http://www.componentone.com/TECHWRL/DocToHelp2005

---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- techwr-l -dot- com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.



Previous by Author: Insurance issue resolved!
Next by Author: Re: Maintaining a common set of web site links
Previous by Thread: Re: Bookmarks misaligned in Adobe Acrobat PDF
Next by Thread: Visual SourceSafe for Documentation Source Control


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


Sponsored Ads