durusmail: quixote-users: Re: Popularity of Quixote
Re: Popularity of Quixote
2005-10-25
2005-10-26
2005-10-26
2005-10-26
2005-10-26
2005-10-26
2005-10-26
Re: Popularity of Quixote
Titus Brown
2005-10-26
-> >  * update the Quixote documentation, perhaps by making it into pure
-> >         reference docs (epydoc, anyone?),
->
-> I've become a big fan of Restructured Text.  If only it was stable
-> enough when we were writing the Cheetah documentation, we wouldn't
-> have had to use LaTeX.

The current docs are in reStructuredText (as is my tutorial, actually --
I'm a big fan, too!) but I am arguing that reference docs produced
directly from the source code, along with an overview doc & perhaps the
demo docs, are all that the mems-exchange people should need to support.

Partly it's that producing docs from source code is the most reliable
way to have very accurate docs!

--titus
reply