Wow, Sphinx is doing a pretty good job at being adopted as a docs tool for Python web frameworks - Grok, Django, Pylons, and repoze.bfg have all adopted Sphinx usage in the last few months or so!
The "Projects using Sphinx" page can be updated from (upcoming) to an in-use Sphinx URL for some of these projects. For Grok we made the Sphinx-docs "official" last week.Thanks to Uli Fouquet for getting the basic groundwork laid for Sphinx docs for Grok - I've been finishing the job, applying polish and learning Sphinx as I go. Quite impressed so far! http://grok.zope.org/doc/current/ The next step for these docs is to use the autoclass extension and Tres's new autointerface extension (http://pypi.python.org/pypi/ repoze.sphinx.autointerface/) so that Sphinx docs are more in-sync with the source code docs - I wonder if an autoabc extension would also make sense, or maybe the existing autoclass could be extended to understand ABCs? Hmm, and perhaps a way to indicate that a normal Class is intended to be used as a base class in the autoclass extensions would be interesting - in Grok there are a lot of base classes that you are intended to inherit from, it might be nice to mark those classes as "base-ish" in the docs. And Django beat us to the punch by almost a month with their Sphinx- backed docs: http://docs.djangoproject.com/ The TurboGears 2 project is still an alpha-ish state, but they do have an URL for their Sphinx docs which I believe will also be stable for the project at: http://turbogears.org/2.0/docs/ --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
