+1 to Stephen Crosbys' proposal, although I think this would be a bit difficult to perform as the Framework evolves and the documentation on this would be a bit outdated as time goes on (And have to yet again maintain another Document to keep up to date).
It it still none the less a good idea in my opinion. On Tue, Apr 20, 2010 at 9:43 AM, Stephen Crosby <stevecr...@gmail.com>wrote: > What could be very helpful here is some education for would-be Django > developers. The tutorial format has worked so well for educating new Django > users, why not apply it also to Django developers also? After the 1.2 > release, why don't we come up with a Django developers tutorial that walks > us through the process of solving issues and working on Django. The goal of > this would be to help would-be developers understand the Django development > process by getting their hands dirty with a real issue. > > It could begin with a short explanation of the process, go through finding > a real (old) example issue in Trac (already solved), it could run down what > type of Trac activity is helpful and what is not. Then the tutorial could > instruct the reader to checkout an old revision of Django (with the unsolved > issue) and how to reproduce the issue. > > We could show the reader how to apply a bad patch (attached by some > less-informed Trac user), then how to run the test suite and notice that > some tests fail. Some instruction on how to politely note that fact on Trac > might be in order as well as how the patch was rewritten in order to pass > the tests. > > Another bit on proper documentation, some notes on quality, where to get > help, what types of issues need discussion on this list would be great and > I'm sure there's more that could be included with this type of tutorial. > > > On Tue, Apr 20, 2010 at 9:09 AM, Jacob Kaplan-Moss <ja...@jacobian.org>wrote: > >> On Mon, Apr 19, 2010 at 3:34 PM, Gabriel Hurley <gab...@gmail.com> wrote: >> > When I finally did submit my first patch, I was terrified of getting >> > it wrong and having it rejected. I'd seen it happen on other tickets. >> > It wasn't until I got *more involved* and started keeping up with the >> > trac timeline--watching the ebb and flow of tickets--that I started to >> > understand how the tone on trac had a reason. Until you get that >> > perspective, it's hard to know what's right or wrong, and easy to take >> > things personally. The core devs can seem imposing or scary simply >> > because you don't know them. >> >> This is *really* good feedback, and thank you very much for it. >> >> Clearly scaring people isn't our intent, but if that's the result... >> well, we're doing something wrong. I really don't want people to be >> scared off, and I'm hearing from you and a few others that that's >> already happening. >> >> I don't think I need to enumerate why the tone on a ticket tracker >> tends towards the terse -- lack of time, repetition, yadayada -- but >> regardless I don't like our process being scary. >> >> > If anything, my point is that getting started as a Django contributor >> > *can* be difficult, and the core team just being aware of that fact is >> > a good thing. >> >> I hear you loud and clear, and I'd love any suggestions you might have >> about how we might improve in this area. >> >> Jacob >> >> -- >> You received this message because you are subscribed to the Google Groups >> "Django developers" group. >> To post to this group, send email to django-develop...@googlegroups.com. >> To unsubscribe from this group, send email to >> django-developers+unsubscr...@googlegroups.com<django-developers%2bunsubscr...@googlegroups.com> >> . >> For more options, visit this group at >> http://groups.google.com/group/django-developers?hl=en. >> >> > > > -- > Stephen Crosby > Web Developer > lithostech.com > > -- > You received this message because you are subscribed to the Google Groups > "Django developers" group. > To post to this group, send email to django-develop...@googlegroups.com. > To unsubscribe from this group, send email to > django-developers+unsubscr...@googlegroups.com<django-developers%2bunsubscr...@googlegroups.com> > . > For more options, visit this group at > http://groups.google.com/group/django-developers?hl=en. > -- You received this message because you are subscribed to the Google Groups "Django developers" group. To post to this group, send email to django-develop...@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.
