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
31029	Link to more specific sections when using the :rfc: role.	Baptiste Mispelon	Baptiste Mispelon	"While looking at the documentation for the `r` format of the `|date` template filter [1], I ended up following the link to the RFC and had to look around the page to find the section that was actually relevant.

It turns out that sphinx's `:ref:` role supports linking to a specific section of an RFC (this feature is already used in a few places in Django's docs).
I think it would be useful to use that when possible and/or relevant.


So I did some grepping (using {{{git grep -E ':rfc:\`[0-9]+\`'}}}) and for each match I tried to see if there was a specific section that was relevant to the context.
I skipped the release notes to save myself some work and because all the matches there were for unsupported versions anyway (10 matches with the latest one for the 1.10 release).

I also added a paragraph in the contributing guide so that other contributors might know about the feature too.

[1] https://docs.djangoproject.com/en/dev/ref/templates/builtins/#date"	Cleanup/optimization	closed	Documentation	dev	Normal	fixed			Accepted	1	0	0	0	0	0