Re: Documentation management

[Jason Huntington <JasonH -at- CAPTURA -dot- COM>]

In addition, VSS supports sharing files between projects in the VSS project
hierarchy.

We use VSS's ability to shadow files to our intranet.  VSS copies
documentation that developers (yes, developers) and other technical writers
add or check in from a shadowed VSS projects to a specified intranet
directory.

Jason R. Huntington

Senior Technical Writer
Captura Software, Inc.

        -----Original Message-----
        From:   Porrello, Leonard [SMTP:lcporrel -at- ESSVOTE -dot- COM]
        Sent:   Friday, December 04, 1998 9:10 AM
        To:     TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU
        Subject:        Re: Documentation management

        I've just started using VisualSource Safe, and it seems to be
decent.

        When you say documents on paper and on-line, can I nevertheless
assume that=
         all of your docs are in electronic format? If so, you can use
something li=
        ke VisualSource Safe to keep close control over the documents. With
it, onl=
        y one user at a time can check-out any single file, and each
revision of ea=
        ch document is saved. Also, when a user is checking a document back
in, VSS=
         allows for the recording of change information.

        VSS is what the developers here use to track their code, but I don't
know h=
        ow you might use it to coordinate software and documentation except
by stor=
        ing the entire product under the same folder. You could have a
Folder for P=
        roduct X, and in it have subfolders for each release, and each of
those sub=
        folders have subfolders for the various parts of the product
(including doc=
        umentation).

        Leonard

         ----------
        From:   deliosoff
        Sent:   Friday, December 04, 1998 10:54 AM
        To:     TECHWR-L; LCPORREL
        Subject:        Documentation management

        I support documentation for a project management system. The system
is
        currently DOS based, but is in the process of being rewritten for
        Windows in VB. Formerly, all documentation was on paper, but now of
        course we want to take advantage of on-line documentation.

        The programmers are incorporating some help as they program, but
very
        shortly I will be involved setting up the documentation for this new
        system. Yes, I know I should have been involved earlier, but let us
        not get into that.

        My questions are this:
        What tools can one use to locate and co-ordinate the interrelation
of
        documentation when it is scattered over numerous modules, both
on-line
        and on paper.

        Do databases exist that can be used to coordinate software and
        documentation changes?



 From ??? -at- ??? Sun Jan 00 00:00:00 0000=
        Send commands to listserv -at- listserv -dot- okstate -dot- edu (e.g., SIGNOFF
TECHWR-L)



 From ??? -at- ??? Sun Jan 00 00:00:00 0000=