On Mon, 2008-03-31 at 13:45 -0500, Jacob Kaplan-Moss wrote: > Right. How will I do this, you say? Here's my plan: > > * Using the outline from the existing documentation > (http://toys.jacobian.org/django/docoutline-r7392/), make a new outline > and figure out where each bit fits into the new regime. This doesn't > need to be in any way perfect or 100% complete; just good enough to get > started from. > > * Following that outline, break up the existing docs. Copy/paste is fine; > no rewriting yet. > > * A few areas will need top-level outlines/indexes. Write those. > > * Go through each document and mark it up with all the gory metadata and > links. This is the part that'll take a crazy amount of work. > > * Rewrite the website documentation tools to work under the new regime > (they'll already build standalone thanks to Sphinx). > > Am I missing anything here? > > So feedback is welcome, please give it. Volunteers are welcome, too, but I'll > probably not be ready to distribute work just yet. I need to finish the > groundwork, and I need to figure out how to best to work without totally > fucking up the existing docs. >
Since all the documentation is already in subversion, it might make sense to have a docs-refactor branch on the tree. > Jacob I volunteered to help out on the documentation at the sprint, and then had to leave before anything got underway on it. I just want to put my hat in the ring again. I'd love to help out, when the time comes for work delegation. Cheers, Cliff --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
