Marty Alchin wrote:
  > So to me, PHP's documentation is better than Django's, but PHP (not
> very OO) also lends itself well to that type of documentation, much
> better than Python, and thus Django. But even Python's standard
> library reference better suits my taste.
This right here is the number one thing want in documentation.  I'd 
prefer to have the documentation separated into reference and tutorials. 
  It feels too tightly coupled for me.  I realize the doc tests provide 
some of that, but I can handle only so many kloc's of doctests :)

Thankfully the information is all there, it'd just be helpful to have it 
separated.  I think it would improve the documentation just as a side 
effect.

Anyways, it looks like I've started getting into the user discussion. 
I'm all for doing taking a fresh look at documentation.

Adam

--~--~---------~--~----~------------~-------~--~----~
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
-~----------~----~----~----~------~----~------~--~---

Reply via email to