Re: meeting-topic: documentation

Joel Palmius <[email protected]> Fri, 23 Sep 2005 18:18:09 +0200 (CEST)
Newsgroups gmane.comp.apache.mod-survey.general
Message-ID <[email protected]>
I don't have any documentation uncommitted. Generally, the documentation 
is available through cvs (checkout "documentation" instead of 
"mod_survey").

For syntax reference, there's a perl script for dumping the available 
parameters and default values to stdout, see 
Survey/Component/buildSyntaxRef.pl. In the rare occasions when I update 
the documentation I compare the reference to this.

For code documentation, I started writing one ages ago, but decided that 
too few people would read it for it to be worth the huge effort of 
producing something readable.

   // Joel


On Fri, 23 Sep 2005, Michael Waider wrote:

> Hi,
>
> we were doing some tests with 3.2.3-pre1 lately and missed an
> uptodate syntax-reference a lot. So we decided to care about the
> documentation-issue at the developer-meeting.
>
> We will prepare a short presentation of documentation-approaches
> in software-development and which of them are most useful for our
> concerted efforts. After the meeting we will take care about
> documentation-updates to have at least the syntax-reference
> uptodate when 3.2.3 stable will be released.
>
> So please send in everything about documentation in advance
> (@Joel: the current documentation-sources, @Bugant/Martin:
> anything you have noted about your latest code-contributions,
> @all: any ideas or wishes about a practical documentation-system
> for modsurvey).
>
> thx + cheers    Mike
>
> -- 
> eveca GmbH - Internet & Befragungen - http://eveca.de
> Fon: 0941/785368-0 - Fax: 0941/785368-99
> Skickat av Michael Waider <[email protected]>
> till survey-discussion
>
Skickat av Joel Palmius <[email protected]>
till survey-discussion