id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
25263	How closely we should adhere to PEP 257	Samuel Bishop	nobody	"Currently the documentation contained in Django's source code has many places where it could be improved, most significantly by having more of it. In order to help discover undocumented code, I ran [https://pypi.python.org/pypi/pep257 PEP 257] on the entire project. The thousands of warnings were quite a shock and it was pretty obvious that a pull request for all of the changes would be too large.

It seemed like a good idea to open this ticket and find out if continuing to create new tickets and pull requests for more of this kind of documentation improvement is in line with the overall project code standards. I'm opening a pull request that contains a partial cleanup of the existing documentation inside 'django.views'.  https://github.com/django/django/pull/5131"	Cleanup/optimization	new	Documentation	dev	Normal				Unreviewed	0	0	0	0	0	0