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
27963	Docstring example in docs doesn't follow PEP 257	Mikkel Munch Mortensen	nobody	"This is a bit of a pedantic issue with the docs.

[https://docs.djangoproject.com/en/dev/internals/contributing/writing-code/coding-style/ This page] says ""In docstrings, follow PEP 257"". Which is then immediately followed by an example that does _not_ follow the PEP 257 convention for one-line docstrings. Is that something that has been discussed a billion times or is it actually a bug?

It caused a somewhat heated discussion on our team today :)"	Cleanup/optimization	closed	Documentation	1.10	Normal	fixed			Accepted	1	0	0	0	0	0