On Sun, Jul 4, 2010 at 8:29 PM, dffdgsdfgsdfhjhtre <nbvf...@gmail.com>wrote:
> I may be in the minority here, but I believe grepping source should > never, ever, ever be an acceptable substitution for proper > documentation. > I agree with you here. As I said, I don't think this workflow should be imposed on everyone, and I do agree that these should be documented. Then how else should the docs be re-organized? You seem to be arguing > for there being no documentation at all. Should we just put everything > into docstrings and tell people to use epydoc and help()? > I'm saying that the autogenerated documentation I see all around the web in most cases is not the least useful. I'm saying that the documentation has to be more in depth, about how (and specially why) to use something, not just describe a function's arguments and output. -- 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.
