Document how intersphinx linking works
Documentation should be added to http://pulp.readthedocs.org/en/latest/dev-guide/contributing/documenting.html#editing-the-docs
When you want to reference docs of any of the projects mentioned in `intersphinx_mapping` just add the following code:
:ref:`importer config docs <puppet:configuration>`
The above example relies on 'puppet' being defined in `intersphinx_mapping`. It also relies on a label called 'configuration' existing in the puppet docs.
A list of all labels for a project can be found by using this script: https://gist.github.com/dkliban/683c3e9cdfc1ba884226/c8c3e0e10fef5dbe7525cd1b1137357e93862685
Save the gist as an executable called `inventory.py` and then invoke the following command:
./inventory.py --url http://pulp-puppet.readthedocs.org/en/2.6-release/objects.inv
The URL can point to any RTD builder. Each of our builders generates an objects.inv each time the docs are built.
If you don't see the label that you wish to link to, then you need to create one. A label can be created by adding the following tag:
The above code will create a label1 that can be reference externally. If `label1` was added to the `puppet` project then it can be referenced with:
:ref:`importer config docs <puppet:label1>`
Please register to edit this issue