TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
>Gwyneth Runnings told us:
>> >I'm wondering if anyone has used specific software
>> >programs that track code changes-
>> My last company used Visual Source Safe, which I think many others
>> use as well. In order to change a file, the programmer or other user
>> has to check it out. This prevents people from working on the same
>> document at the same time and also preserves the earlier versions.
>> You can view the previous version and the new version side by side
>> and it highlights the changes.
>That or CVS, but how does anyone ELSE know that somebody has made
>any changes, and what the changes ARE. Most such version control
>tools offer a comparison between two versions of a file, but just
>requesting the difference report, let alone interpreting that report,
>can be tricky. I'm dealing with a team of about 5 engineers who are
>making changes across 6 versions of an API. Each has his/her own
>idiosyncratic style for commenting what the changes they made were.
>Some are excellent, but others report things like "changed some
>--Guy K. Haas gkhaas -at- usa -dot- net aka ghaas -at- selectica -dot- com
> Software Exegete in Silicon Valley
In VSS the whole history of who has worked on the file is available
to every user, and you can compare any two files in the history, but
you have to be able to read the code and have an idea of what the
changes mean. Or you have to get your programmers to write comments
in the comments field of VSS. You can look at the history and say,
Hey Bob was working on that file. I can see he changed this line of
code, although I don't see any comments.
Yes, you're right it does still require interpertation.
Announcing new options for IPCC 01, October 24-27 in Santa Fe,
New Mexico: attend the entire event or select a single day.
For details and online registration, visit http://ieeepcs.org/2001
Your monthly sponsorship message here reaches more than
5000 technical writers, providing 2,500,000+ monthly impressions.
Contact Eric (ejray -at- raycomm -dot- com) for details and availability.
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit http://www.raycomm.com/techwhirl/ for more resources and info.