Lenard
One advantage with formal documentation is it can be kept synchronized
with Python doc strings. The current Pygame doc system does this in a
limited way. Hopefully a move to reST will encourage even greater
coordination. How would this be done with a wiki? Only the author of a
new Pygame feature knows what it should actually do. Unfortunately the
existing docs containing many second hand guesses. How will a wiki give
better descriptions. As a developer, it is as easy for me to edit the
docs in SVN as a wiki page. The Python approach to cooperative
documenting is to encourage users to submit patches which are then
incorporated into the formal documents. But this is not to discourage a
wiki document. But maybe it can complement the formal docs, be more of a
user's guide then a api reference.
- Re: [pygame] Using reStructuredText for document sou... René Dudfield
- Re: [pygame] Using reStructuredText for document... Greg Ewing
- Re: [pygame] Using reStructuredText for docu... Lenard Lindstrom
- Re: [pygame] Using reStructuredText for document sources jug
- Re: [pygame] Using reStructuredText for document sou... René Dudfield
- Re: [pygame] Using reStructuredText for document sou... David Burton
- Re: [pygame] Using reStructuredText for document... Greg Ewing
- Re: [pygame] Using reStructuredText for docu... David Burton
- Re: [pygame] Using reStructuredText for docu... Julian Marchant
- Re: [pygame] Using reStructuredText for ... David Burton
- Re: [pygame] Using reStructuredText for document... Lenard Lindstrom
- Re: [pygame] Using reStructuredText for docu... James Paige
- Re: [pygame] Using reStructuredText for ... Lenard Lindstrom
- Re: [pygame] Using reStructuredText for document sou... Lenard Lindstrom
- Re: [pygame] Using reStructuredText for document... David Burton
- Re: [pygame] Using reStructuredText for docu... David Burton
- Re: [pygame] Using reStructuredText for ... David Burton
- Re: [pygame] Using reStructuredText... Lenard Lindstrom
- Re: [pygame] Using reStructured... René Dudfield
- Re: [pygame] Using reStructured... David Burton
- Re: [pygame] Using reStructured... René Dudfield