Re: Proposal for documentation reform

2006-06-18 Thread Simon
I have to agree that the documentation for Django is lite years ahead of other frameworks I've looked at (no names! :-), but improvement is always a worthy goal. It is really fantastic to see other people writing up tutorials and documentation - it shows that people are really getting stuck in to

Re: Proposal for documentation reform

2006-06-18 Thread Malcolm Tredinnick
[OK, this is longer than I intended. Sorry 'bout that. :-( Short version: yes, I agree. Focus on the organisation, too; we already have a lot of content; people apparently don't read the docs anyway; how we can kickstart this a bit; and some clues from other projects I've help on and hung around.

Re: Proposal for documentation reform

2006-06-18 Thread Erik Stein
Hello -- I'm rather new to django so please forgive my ignorance. It's only some weeks that i work with django but i'm as productive as it could be thanks to this very well-thought and well-programmed framework. Mainly i am missing two aspects in the otherwise really great and useful doc

Proposal for documentation reform

2006-06-17 Thread James Bennett
I've had some thoughts bouncing around in my head for a while about Django's documentation, and I think it's time to finally commit them to tangible form, so here goes: Compared to either the standard open-source project or the standard piece of web software, Django's documentation is good. Reall