From ae1e2e680867559fb97da869086ccfcfc4cbd62d Mon Sep 17 00:00:00 2001 From: chenxing Date: Fri, 14 Jun 2019 19:10:25 +0800 Subject: doc: Start using openstackdoctheme's extlink extension This ensures we have version-specific references to other projects [1]. Note that this doesn't mean the URLs are actually valid - we need to do more work (linkcheck?) here, but it's an improvement nonetheless. [1] https://docs.openstack.org/openstackdocstheme/latest/#external-link-helper Change-Id: I7c979dacd89ebead404b751d596ba120b38f00f3 --- doc/source/contributor/CONTRIBUTING.rst | 6 ++---- doc/source/contributor/index.rst | 2 +- doc/source/contributor/running-tests.rst | 4 ++-- 3 files changed, 5 insertions(+), 7 deletions(-) (limited to 'doc/source/contributor') diff --git a/doc/source/contributor/CONTRIBUTING.rst b/doc/source/contributor/CONTRIBUTING.rst index 3d86d1c06..83632d44d 100644 --- a/doc/source/contributor/CONTRIBUTING.rst +++ b/doc/source/contributor/CONTRIBUTING.rst @@ -1,5 +1,3 @@ -.. _CONTRIBUTING: - ================= How To Contribute ================= @@ -77,8 +75,8 @@ multiple processes generally use a base image and child images, for example, ``glance-base``, ``glance-api``, and ``glance-registry``. Jinja2 'blocks' are employed throughout the Dockerfile's to help operators -customise various stages of the build (refer to `Dockerfile Customisation -`__) +customise various stages of the build (refer to :ref:`Dockerfile Customisation +`) Some of these blocks are free form however, there are a subset that should be common to every Dockerfile. The overall structure for a multi container service diff --git a/doc/source/contributor/index.rst b/doc/source/contributor/index.rst index 44766f0f6..40c5b0d19 100644 --- a/doc/source/contributor/index.rst +++ b/doc/source/contributor/index.rst @@ -12,7 +12,7 @@ We welcome everyone to join our project! .. toctree:: :maxdepth: 2 - CONTRIBUTING.rst + CONTRIBUTING running-tests bug-triage ptl-guide diff --git a/doc/source/contributor/running-tests.rst b/doc/source/contributor/running-tests.rst index ebd82007c..5d30703be 100644 --- a/doc/source/contributor/running-tests.rst +++ b/doc/source/contributor/running-tests.rst @@ -107,8 +107,8 @@ Then run :command:`tox` with the debug environment as one of the following: tox -e debug tox -e debug test_file_name.TestClass.test_name -For more information see the `oslotest documentation -`_. +For more information see the :oslotest-doc:`oslotest documentation +`. .. rubric:: Footnotes -- cgit v1.2.3