Philipp Keller: >> So I'd like to propose that we draw up some guidelines for >> contributing documentation for Django, and begin encouraging >> documentation contributions just as much as we encourage code >> contributions. > > I'm not 100% sure this is the right direction. > As I found out there's lacking documentation in newforms I digged into the > django code and figured it out and set up a little tutorial. > The barrier would have been much higher if I had to write official > documentation. Additionally bloggers (as me) want to publish on their own > sites: to increase traffic, get comments, get in touch with other users, etc.. > > I would rather encourage users to post their documentation wherever and let > them add a comment on a corresponding documentation site. > Later on, someone would ask such a poster if his post may be used for > official documentation and if he would be willing to incorporate the doc to > the official doc.
What about filing a ticket that says "I've put some documentation on ... on ..." Someone else could then build a patch to include the text in the docs. I think that for docs separating these two stages works better than for code. And for the blogger it's an additional link to his/her blog, so they have an interest to make the ticket. When I look at the tickets, I often see that the ability to make a patch does not come out of thin air, and perhaps people who write good docs are not always used to working with patches. > Granted, I've got the bloggers view on this :-) Well, as this involves you bloggers, I guess your point of view is essential here! Michael -- noris network AG - Deutschherrnstraße 15-19 - D-90429 Nürnberg - Tel +49-911-9352-0 - Fax +49-911-9352-100 http://www.noris.de - The IT-Outsourcing Company --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
