× The internal search function is temporarily non-functional. The current search engine is no longer viable and we are researching alternatives.
As a stop gap measure, we are using Google's custom search engine service.
If you know of an easy to use, open source, search engine ... please contact support@midrange.com.




On Jan 6, 2012, at 2:08 AM, midrange-l-request@xxxxxxxxxxxx wrote:

Have any of you found good answers to either of these questions for a
shop with 5 or more developers?

1) How do y?all make people aware what reusable routines exist?

2) How do folk find what a reusable routine does, short of reading the code?

Documentation? <grin>

The best way I believe is to use an RPGDoc tool (Paul Tuohy has one linked from here http://systemideveloper.com/downloads.html )

We have also used a wiki (pmwiki in our case) as a central repository for documentation.

I also subscribe to the notion of using the prototypes for basic documentation and examples of useage. I also group the protos of multiple routines into a single file to minimize the number of places that have to be searched.

Jon Paris

www.partner400.com
www.SystemiDeveloper.com





As an Amazon Associate we earn from qualifying purchases.

This thread ...

Follow-Ups:

Follow On AppleNews
Return to Archive home page | Return to MIDRANGE.COM home page

This mailing list archive is Copyright 1997-2024 by midrange.com and David Gibbs as a compilation work. Use of the archive is restricted to research of a business or technical nature. Any other uses are prohibited. Full details are available on our policy page. If you have questions about this, please contact [javascript protected email address].

Operating expenses for this site are earned using the Amazon Associate program and Google Adsense.