[p4] Documentation file formats (Or: How do you manage docs a cross bra nches ?)
orens at p-cube.com
Tue Jun 15 07:14:26 PDT 2004
I was hoping for information about the current state of affairs, i.e. :
How are U handling this issue ?
Do you maintain documentation in text-based files ?
Which format ?
Which tools are you using ?
I need to find a working substitute before I can talk with people here about
abandoning Word, and I do not have enough experience with other formats...
From: Arnt Gulbrandsen [mailto:arnt at gulbrandsen.priv.no]
Sent: Tue, June 15, 2004 1:52 PM
To: Oren Shemesh
Cc: Perforce User Group (E-mail)
Subject: Re: [p4] Documentation file formats (Or: How do you manage docs
across bra nches ?)
I'll keep this general, because I really can't argue with the statement
"Microsoft Office shall be used." Such a requirement ends all
discussion, as far as I'm concerned. So I'll make some general
statements and perhaps you can make use of them.
I've done a little documentation on over the years, versioned in cvs and
Text changes. For text, you need a mergable format.
Tables change less often. Best to have it there too. If you can generate
the tables from a versionable text format, that's ideal.
Graphics don't change much, in my experience. (Generated graphics do,
but in those cases it's better to store the source, of course.)
If you can find a way to split your documentation into text-only and
graphics-only files, you may find that the text files merge easily and
the graphics files don't present much of a problem. When graphics files
need merging, they often need human attention anyway.
Can you do that?
perforce-user mailing list - perforce-user at perforce.com
More information about the perforce-user