"Brett" <no@spam.com> wrote in message
news:OJ**************@TK2MSFTNGP14.phx.gbl...
Where is a good place to document version updates to a simple program?
This isn't anything a user will see. Only developers.
I was thinking of including an empty class file just for documenting
revisions. They will only be comments.
Also, I'd like to put these comments in XML format. How can that be done
and where should it be stored? The program is just an EXE with no other
files. I'd like to keep it that way.
Thanks,
Brett
You will also need a big stick to beat the developers and make them fill out
such a file.
Personally, I would never trust such a piece of documentation unless it was
me wrote it.
I have worked on so many systems where the documentation and comments are
out of step with the actual code.
What I've seen work is where each change request is documented by someone
and the developers can only release code where they have a change request.
With these systems there was actually someone responsible for maintaining
change requests and the manager handed out work in terms of these.
Sourcesafe code had change request numbers commented into each version.
If you wanted to, you could use sourcesafe to track down specific code
changes between the versions and thus change requests.
I've also used the buddy/walkthrough technique where changes are discussed
with at least one other and there's a walkthrough of changes before putting
things live. This way at least two people understand what changes have been
made.
HTH
--
Regards,
Andy O'Neill