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

Reply via email to