Re: Documentation wishlist

Tony Graham <[email protected]>
Newsgroups gmane.text.xml.xmlroff.general
Message-ID <[email protected]>
Steve Cheng <[email protected]> writes:
> On Mon, 13 Sep 2004, Tony Graham wrote:
>
>> Did you see <http://xmlroff.org/phpwiki/index.php/DesignNotes>?
>>
>> It hasn't been added to recently since there's been no indication of
>> people reading it.
>
> Oh, sorry, didn't see that. (Thought it would be in the same
> place as the code documentation.)

The theory was that that stuff would be drafted in the Wiki and then
put in the code documentation when it was stable.

That intention also predates the nominally monthly release schedule.
With regular releases, there's now less lag time between updating the
DocBook documentation and publishing it in a release.

>> Then ask where to start.  Either ask for suggestions on how to do what
>> you want to do or ask for suggestions for simple things that you can
>> do.  There's also the bug reports and enhancement requests on the
>> SourceForge project site.
>
> (When I get my head around the design, I'll try something.
> I think I reasonably understand the XSL-FO spec now.)

I bet that if you transcribed the Wiki documentation into DocBook and
put it in the code documentation, you'd know a lot more about the
design than you do now.

Regards,


Tony.



-------------------------------------------------------
This SF.Net email is sponsored by: YOU BE THE JUDGE. Be one of 170
Project Admins to receive an Apple iPod Mini FREE for your judgement on
who ports your project to Linux PPC the best. Sponsored by IBM. 
Deadline: Sept. 13. Go here: http://sf.net/ppc_contest.php
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.