>4. Task-oriented indexes: "I need to unit test my application", "I >need to audit the security of my site", "I need to extend the auth >system", etc.
These ones are often overlooked, I think. If you look at PHP's documentation there's a lot of "how-to"-style documents. How do I write a guest book, how do I write a contact form, how do I write a banner adv rotator, etc etc. I think these have been really beneficial for PHP's uptake - it's kind of rare to dive in and build a webapp from the ground up. Instead, people start with their website and as it grows, want to plug-in extra functionality. They decide that they want a guestbook, or a forum, and look around for a tutorial, slot it in, and off they go. Now, Django's not as suited for that stuff as PHP is (you can't easily drop a django app into an existing website without some webserver kung- fu), but I think this is a good approach to take. This documentation niche is often filled by bloggers (James is doing an excellent job here), and this is the main reason I started the Tutorials wiki page to fill that gap [1] (please add things to that list!). I think there's a big gap in our existing docs between "here's a quick- and-easy polls app" to "here's the full documentation for database API". I think it would be a great idea to have some task-orientated beginner/medium/high level how-to/tutorial guides. This stuff is often quite short and sweet and can plug in gaps in the existing docs relatively easily. For example - this thread alone has seen some discussion of "how to speed up saving to the database". 10 minutes typing that into a wiki page/blog post would be really helpful to someone. --Simon [1] http://code.djangoproject.com/wiki/Tutorials --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "Django developers" group. To post to this group, send email to django-developers@googlegroups.com 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 -~----------~----~----~----~------~----~------~--~---
