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
20975	Fix incorrect markup of committers list (and possibly other docs lists)	Daniele Procida	Daniel Boeve	"The list of Django committers - https://docs.djangoproject.com/en/dev/internals/committers/ - should be three HTML definition lists. In fact, it's dozens of definition lists, of the form:

{{{
<dl>
    <dt>Name</dt>
    <dd>Description</dd>
</dl>
<dl>
    <dt>Name</dt>
    <dd>Description</dd>
</dl>
[... and so on]
}}}

This is because it is marked up incorrectly.

Incorrect:

{{{
Marc Tamlyn
    Marc currently works at `Incuna Ltd`_, [...]

.. _Incuna Ltd: http://incuna.com/
}}}

Correct:

{{{
Marc Tamlyn
    Marc currently works at `Incuna Ltd`_, [...]

    .. _Incuna Ltd: http://incuna.com/
}}}

The incorrect form places the reference for the links in the previous block at the start of the line, rather than indented to the same column as the block. This causes a new definition list to be started the next time the markup for a definition term (i.e. `<dt>Name</dt>`) is encountered.

It's quite possible that the same problem occurs elsewhere in the documents, so it would be worth checking.

I would like to reserve this ticket for first-time committers who take part in the [http://www.djangocon.us/schedule/presentation/7/ Don't be afraid to commit tutorial] and the sprints at  [http://djangocon.us/ DjangoCon US 2013] in September.

However, if you want to tackle this ticket before then, please '''don't''' hesitate. Feel free to re-assign it to yourself and do whatever you like to it."	Cleanup/optimization	closed	Documentation	dev	Normal	fixed	afraid-to-commit		Accepted	0	0	0	0	1	0