#30624: Use numbered list reStructuredText syntax throughout the docs.
------------------------------------------------+------------------------
Reporter: Jon Dufresne | Owner: nobody
Type: Cleanup/optimization | Status: new
Component: Documentation | Version: master
Severity: Normal | Keywords:
Triage Stage: Unreviewed | Has patch: 0
Needs documentation: 0 | Needs tests: 0
Patch needs improvement: 0 | Easy pickings: 0
UI/UX: 0 |
------------------------------------------------+------------------------
reStructuredText has syntax to automatically number ordered lists. To use
it, begin list items with `#. ` rather than an explicit number. The
numbered list syntax simplifies future maintenance:
- As items are added or removed, the rendered items are automatically
renumbered.
- If a long list happens to reach double digits, all items remain indented
the same.
Sphinx documentation on the feature: http://www.sphinx-
doc.org/en/master/usage/restructuredtext/basics.html#lists-and-quote-like-
blocks
--
Ticket URL: <https://code.djangoproject.com/ticket/30624>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
To view this discussion on the web visit
https://groups.google.com/d/msgid/django-updates/052.5d886977a9f4664b56d8e49048fe54da%40djangoproject.com.
For more options, visit https://groups.google.com/d/optout.
