Re: New documentation outline (was: Refactoring the documentation)

2008-04-04 Thread Jacob Kaplan-Moss
On Fri, Apr 4, 2008 at 12:39 PM, Adam <[EMAIL PROTECTED]> wrote: > Apologies in advance if this is out of scope of the discussion here, > but I just wanted to make sure that the existing documentation for > django 0.91 [1] isn't lost in the shuffle. It won't. I'll probably just flatten what's

Re: New documentation outline (was: Refactoring the documentation)

2008-04-04 Thread Adam
Apologies in advance if this is out of scope of the discussion here, but I just wanted to make sure that the existing documentation for django 0.91 [1] isn't lost in the shuffle. It appears that this documentation is at least somewhat outside the process of the rest of the documentation (0.95,

Re: New documentation outline (was: Refactoring the documentation)

2008-04-02 Thread [EMAIL PROTECTED]
> Once the refactor is complete we can start looking at writing new stuff. Sorry, posted my last message before seeing this. --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups "Django developers" group. To post to this

Re: New documentation outline (was: Refactoring the documentation)

2008-04-02 Thread [EMAIL PROTECTED]
> While I agree with the importance of having reusability tips, I would > certainly argue against putting it anywhere near django.contrib. When > I started working on my first app, I had unnecessary delusions of > getting into django.contrib when it was ready. I wouldn't want to > cause more

Re: New documentation outline (was: Refactoring the documentation)

2008-04-02 Thread Jacob Kaplan-Moss
On Wed, Apr 2, 2008 at 5:58 PM, SmileyChris <[EMAIL PROTECTED]> wrote: > I'd suggest moving install to a how-to rather than a topical guide. > Perhaps deployment could go under there, too? They seem closely > related. So the idea is that "topics" are for focused, core topical guides;

Re: New documentation outline (was: Refactoring the documentation)

2008-04-02 Thread Jacob Kaplan-Moss
On Wed, Apr 2, 2008 at 6:05 PM, [EMAIL PROTECTED] <[EMAIL PROTECTED]> wrote: > One thing that struck me while looking over this list is that it might > be a good idea to add a section on best practices for writing reusable > apps. James Bennett's presentation at PyCon hit on some really good

Re: New documentation outline (was: Refactoring the documentation)

2008-04-02 Thread Marty Alchin
On Wed, Apr 2, 2008 at 7:05 PM, [EMAIL PROTECTED] <[EMAIL PROTECTED]> wrote: > One thing that struck me while looking over this list is that it might > be a good idea to add a section on best practices for writing reusable > apps. James Bennett's presentation at PyCon hit on some really good

Re: New documentation outline (was: Refactoring the documentation)

2008-04-02 Thread [EMAIL PROTECTED]
Looks really good--a lot cleaner and better laid out than the current docs! One thing that struck me while looking over this list is that it might be a good idea to add a section on best practices for writing reusable apps. James Bennett's presentation at PyCon hit on some really good main

Re: New documentation outline (was: Refactoring the documentation)

2008-04-02 Thread SmileyChris
I'd suggest moving install to a how-to rather than a topical guide. Perhaps deployment could go under there, too? They seem closely related. --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups "Django developers" group.

New documentation outline (was: Refactoring the documentation)

2008-04-02 Thread Jacob Kaplan-Moss
Hi folks -- I've finished making a new outline for the documentation based on my proposal I posted last week. It's available online: HTML: http://toys.jacobian.org/django/new-docs-outline/ OPML: http://toys.jacobian.org/django/new-docs-outline.opml OmniOutliner: