diff --git a/docs/internals/contributing/writing-documentation.txt b/docs/internals/contributing/writing-documentation.txt index 771792c3de2..a71a9126a41 100644 --- a/docs/internals/contributing/writing-documentation.txt +++ b/docs/internals/contributing/writing-documentation.txt @@ -58,9 +58,7 @@ Then from the ``docs`` directory, build the HTML: $ make html To get started contributing, you'll want to read the :ref:`reStructuredText -Primer `. After that, you'll want to read about the -:ref:`Sphinx-specific markup ` that's used to manage -metadata, indexing, and cross-references. +reference `. Your locally-built documentation will be themed differently than the documentation at `docs.djangoproject.com `_. @@ -231,8 +229,8 @@ documentation: Django-specific markup ====================== -Besides the :ref:`Sphinx built-in markup `, Django's -docs defines some extra description units: +Besides :ref:`Sphinx's built-in markup `, Django's docs +define some extra description units: * Settings::