-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Mark Eichin wrote: > On Fri, Nov 14, 2008 at 2:17 PM, Glenn Hutchings <[EMAIL PROTECTED]> wrote: >> Cheers for a great tool that actually makes programmers *want* to >> write documentation! > > Yeah - I've noticed the effect, but don't understand it :-)
A major advantage is that the tool actually works and works well even on large projects such as Python. There aren't many open source projects with a 0.4 version number that are as complete and stable, and almost none that actually look good. Sphinx itself is well documented, although I'd like a few more examples. But any site that uses Sphinx has "Show Source" so you can trivially see how things were done. That isn't remotely possible with most documentation systems. The support for multiple output formats is great. We all want our documentation to be as widely usable as possible. Most systems seem to have a sweet spot - eg they can do PDF or CHM really well, but other formats don't come out as well. Finally Sphinx does all this without forcing the author to use some variant on XML. That by itself would win anyone over :) Roger -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.9 (GNU/Linux) iEYEARECAAYFAkkd9CIACgkQmOOfHg372QTWigCdFHM6cWhhUm9+hMgK0InYLRPk yrkAnRcuEjuM0HInL8mWfdrQCrNNyt8Z =BttQ -----END PGP SIGNATURE----- --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en -~----------~----~----~----~------~----~------~--~---
