Re: Re: https://docs.xaraya.com/

"Michael Cortez" <[email protected]> Wed, 9 Oct 2002 07:58:03 -0700
Newsgroups gmane.comp.cms.xaraya.documentation
Message-ID <018401c26fa4$44b4e260$0801a8c0@tarsis>
>> phpDocumentor, which is on deck, may very well do both and provide some
cool
>> output options (RTFs, Word docs, PDFs, etc.).  More to come as I know
more.
>
> Maybe this one will be able to document functions :)

Correct me if I'm wrong, but this looks simply like a PHP version of
JavaDoc.  For those unfamiliar with JavaDoc -- what it does is allows you to
put specially formatted comments in your source code.  The program then goes
through your source code, and automatically documents your APIs, your
parameters, their types, and then adds your comments about those parameters
and functions to the documentation.

This is nice for self documenting code, but it still doesn't solve the
problem of providing usage documentation for Web Masters, or design
documents for designers/developers.

--
Mike