I've been looking at using the sphinx tools for overhauling the Satchmo documentation too. There's far far less documentation in that project so it is easier but I am anxious to see how you do it. IMHO, Django really has some best practices with documentation so I appreciate the fact that you're keeping the process open. It should help other people do the same thing with their projects.
One thing I'm trying to figure out in my small set of docs is how frequently I want/plan to use the index and glossary functionality that comes with sphinx. How much additional meta data do you hope to add to the docs? Adding more index directives (for example) could be quite time consuming and I'm not sure how useful it would be. The glossary is another intriguing concept but I'm not sure how useful it is. I'm curious what your approach might be with these types of sphinx features. Anyway, looking forward to the process - so I can "leverage" it for Satchmo. -Chris --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "Django developers" 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/django-developers?hl=en -~----------~----~----~----~------~----~------~--~---
