On Fri, Jan 16, 2009 at 2:53 PM, Geoffrey Ducharme < geoffrey.ducha...@gmail.com> wrote:
> There was some talk on this list about updating the django book a few weeks > ago. There were three people who had manifested interest in obtaining > updated documentation. I don't know if they did anything about it, though. > > I do know that there are a few inconsistencies in the main site > documentation that I wanted to address. > > From what I gather, the documentation effort have been mostly voluntary and > not well organized. For example, I don't think there is a mailing list for > documentation feedback. People like you seem to pop in from time to time, > ask a few questions and then leave. > > If someone who had been involved in the project for longer wants to > disprove me, I'd be glad to take it back. But all of the above have been my > impression so far. > > > 2009/1/16 adrian_nye <adrian...@gmail.com> > >> >> I'm an experienced technical writer (10 years at O'Reilly, author of >> several programming books that have done well, editor of others). >> >> I'm now doing Django programming, one site completed and a second on >> the way. >> I'd like to contribute to the doc if there's interest in some help >> from an expert writer but non-expert django programmer. >> >> I have found that writing during the learning process has produced my >> best work >> since I have the same questions and problems that newbies have. >> >> Not that the docs are bad, on the contrary. But I think they need to >> be better for Django to compete with all the established choices. >> >> >> >> > > > -- > Remove the roadblocks > > > > > The long and the short of it is(from my perspective), "patches welcome". If there's something in particular you find subpar about the documentation, be it a confusing paragraph or something that just isn't well covered enough please submit a ticket and provide a patch. If you have specific question please feel free to ask on either IRC or the appropriate mailing list, but doc improvement are handled through the same procedure as code fixes. Alex -- "I disapprove of what you say, but I will defend to the death your right to say it." --Voltaire "The people's good is the highest law."--Cicero --~--~---------~--~----~------------~-------~--~----~ 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 django-developers+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/django-developers?hl=en -~----------~----~----~----~------~----~------~--~---