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
26020	Standardize restructed text header convention in docs	Tim Graham	Elif T. Kuş	"It would be nice to fix some inconsistencies in our heading styles and document the convention in `docs/internals/contributing/writing-documentation.txt`. To avoid changing everything, I think we should deviate slightly from [http://documentation-style-guide-sphinx.readthedocs.org/en/latest/style-guide.html#headings the sphinx style guide] and use something like this (where ""four"" and below are subject to change depending on what documents already use):
{{{
===
One
===

Two
===

Three
-----

Four
~~~~

Five
^^^^
}}}


I attached a patch to get started. Note that any top level `.. _` links can be removed. These are replaced with `:doc:`."	Cleanup/optimization	closed	Documentation	dev	Normal	fixed			Accepted	1	0	0	0	1	0