I filed bug report 
#25952 <https://code.djangoproject.com/ticket/25952>but apparently it was 
in the wrong place.  And I referenced this post 
<https://groups.google.com/forum/#!searchin/django-users/documentation/django-users/1qHviCZMPJA/_8qVb0YYdhAJ>,
 
but I was thinking it was this group ... I wonder how that happened?

So I am hereby suggesting that the road map for the v. 2.0 release include 
revamped documentation.  

It should begin as soon as possible with the somewhat standard best 
practice of collecting "find what you were looking for" or "was this page 
helpful" or "rate this page on its organization, clarity, brevity, etc." 
data on every single existing page.  

It might also be helpful to evaluate how different audiences access the 
docs.  Tutorials are great -- module and class libraries, not so much.

With resulting user feedback along with expert categorization of 
documentation use cases, as with any writing exercise, there must be an 
outline.  The existing outline might be a good place to start.

Oh, and those pesky deadlines, when is v. 2.0 slated for release?


-- 
You received this message because you are subscribed to the Google Groups 
"Django developers  (Contributions to Django itself)" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at https://groups.google.com/group/django-developers.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/django-developers/460b1aa4-bbb6-45e2-8619-0fb6d9af4f62%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

Reply via email to