Re: MQSeries documetation review, and karma request.
| From: | Ing. P.N.M. Tjon A Hen | Date: | Sun, 30 Dec 2007 16:03:18 +0000 |
| Subject: | Re: MQSeries documetation review, and karma request. | ||
| References: | 1 2 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969378501@lists.php.net to get a copy of this message | ||
Group,
(What an awful name to call you all) like adressing people with people :)
never mind.
I made the changes and the documentation is again downloadable.
>
> - XML intention is one space (a few exceptions, see below)
Done
> - PHP code (in the examples) is four spaces as it follows the PEAR
> coding standards
Done
> - The <!-- --> at end of each file should be the same, with no indenting
Done
>
> - <book xml:id is on a single line
Done
> - <![CDATA[ and ]]> are flush left, no indention
Done
> - <title>'s are always on a single line
Done
> - <member> in seealso are on a single line
Done
> - <refpurpose> also on a single line
Done
>
>
> - Rename install.xml to configure.xml (mqseries.installation)
Done
> - Use &reftitle.install; inside configure.xml
Done
> - Rename configuration.xml to ini.xml (mqseries.configuration)
Done
> - If <refsect1 role="notes"> is empty, don't include it in the docs
Done
> - If a function has no return value, use &return.void; in the return
> role
Done
> - Spelling issues, but I'm guessing you already found these
Uuh think I did it. (English is not my native language, so please be gentle)
>
Regards,
Philippe
PS
Any body has seen XMLMind for docbook editing? I use it for some other
projects creating documentation.