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 Django.
Anyway, I think there are two major types of documentation that people look for: 1) "walkthroughs" - these tend to be oriented around one application, and walk the user through creating them. For example - I want a guestbook, how do I make one? I want a blog, what do I do? The django tutorials fall into this category. These ones tend to be nice and slow, with lots of scenic detail and asides. 2) "lookups" - how do I do x? these tend to be very specific, and happen when the programmer is typing away and wants to, say, get the last n entries in table y with some value equal to z. These should be straight to the point and more concerned with the correct syntax and procedure to use. We really need to aggregate these all into one place - the trac wiki would be best. Have a tutorials section for the walkthroughs and a "how-to" section for the lookups. Skimming through django-developers and django-users should yield quite a few discussions which could be added immediately. --Simon --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
