Automated repository documentation tool?
Alan Dayley
plug-devel@lists.PLUG.phoenix.az.us
Thu Jul 11 14:40:01 2002
Now that I have my CVS repository up, I want to automate some more. What fun!
What tools are out there to automate the creation of repository and event
project documentation? For example:
- CVSTrac is a simple web browser to the repository and issue tracking database
- CVSWeb is a full web based interface to the repository
- Bugzilla is a full blown web based issue tracking application
- Bonsai is a build automation tool.
- cvs2html will generate web pages based on the change log
- doxygen will generate documentation and even diagrams (using dot) of the
source code. Can it do this from the repository? (I haven't tried yet.)
- What will provide nice pictures/diagrams of the project/module/directory
structures? Maybe just a directory tree utility, since the modules are
really sub-directories of the CVSroot directory.
My goal here is to provide good information to the departments outside of
engineering about the different versions of the code. For example, The
Product Manager may want to know which version fixed a specific bug in a
specific project. I want him to be able to hit a web page to show him
that. And give him the tools to show him where that web page is.
I want to create a showcase CVS server that provides not just version
control for the developers but also automatically generated documentation
to other interested people in the company. (Hmm... How hard is it to
install SourceForge locally?) Any pointers to any tools you like (or
dislike) would be great.
Alan
-
/------------------------------------------
|Alan Dayley www.adtron.com
|Software Engineer 602-735-0300 x331
|ADayley@adtron.com
|
|Adtron Corporation
|3710 E. University Drive, Suite 5
|Phoenix, AZ 85034
\-------------------------------------------