Rob Hudson wrote: > I'd like to see more inline documentation of the code. Some .py files > have this but some don't. Just an overview of what the file does, how > things are organized, maybe some concrete examples via doctests. > Something for the average python programmer to get a toehold into what > the code is doing. > > Inline in the code seems like a good place for this to me. It can be > updated as the code changes. And those digging around in the code are > the ones who will benefit the most from it. > > Cheers! > -Rob >
+1 For developers this is IMHO the most useful kind of docs. Most likely to be up2date as well. --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
