Re: Documentation Software Recommendations

It is my experience that no software will document a program to the level that it needs to be in order to be understood (especially at 3 a.m.) when something goes wrong.  Hawkeye is a good starting point, but I would personally have a real set of eyes looking at each program.

Hawkeye doesn't support documenting COBOL or C (at least it didn't when I was using it.

Good luck.
 
Warmest Regards,

Richard Reeve




________________________________
From: Emily Smith <esmith@xxxxxxxxxxxxxxxxxxxx>
To: midrange-l@xxxxxxxxxxxx
Sent: Thursday, June 11, 2009 6:02:32 PM
Subject: Documentation Software Recommendations

Folks,

We're undergoing the task of creating documentation for our iseries programs. The number/size/complexity/god-awful spaghetti code of these programs makes this impossible to do manually. So, we are looking for software to help us along. My research so far has pointed me towards Documint and Hawkeye. I've contacted both companies to set up a trial.
I'd appreciate it if anyone would provide feedback regarding their experiences with these two packages. As an alternative please recommend any other packages.  I'm also happy to hear from vendors.
We are mostly an RPGLE shop though most code is written in RPG III style. We have a handful of COBOL programs, and very small amount of C.

Thanks


Emily Smith
Programmer/Analyst
Bank Data Services
(618)659-4550
CONFIDENTIALITY NOTICE: This email message is private,
confidential property of the sender, and the materials
may be privileged communications intended solely for
the receipt, use, benefit, and information of the
intended recipient indicated above.  If you are not
the intended recipient, you are hereby notified that
any review, disclosure, distribution, copying, or taking
of any other action in reference to the contents of this
message is strictly prohibited, and may result in legal
liability on your part.  If you have received this message
in error, please notify the sender immediately and delete
this message from your system.  We believe that this email
and any attachments are free of any virus or other defect
that might affect any computer system that it is received
and opened in, however, it is the responsibility of the
recipient to ensure that it is virus free and the sender
accepts no responsibility for any loss or damage.