This is an automated email from the ASF dual-hosted git repository.
zrhoffman pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/trafficcontrol.git
The following commit(s) were added to refs/heads/master by this push:
new 089b4d3932 Fix duplicate labels in the documentation (#7077)
089b4d3932 is described below
commit 089b4d39321c8cda0101271d3d2bcb22dfe0e53f
Author: ocket8888 <[email protected]>
AuthorDate: Wed Sep 21 11:02:58 2022 -0600
Fix duplicate labels in the documentation (#7077)
---
docs/source/api/v4/deliveryservice_stats.rst | 4 ++--
docs/source/api/v4/osversions.rst | 4 +---
docs/source/api/v5/osversions.rst | 4 +---
3 files changed, 4 insertions(+), 8 deletions(-)
diff --git a/docs/source/api/v4/deliveryservice_stats.rst
b/docs/source/api/v4/deliveryservice_stats.rst
index 9c785d4a34..45dbba4ce8 100644
--- a/docs/source/api/v4/deliveryservice_stats.rst
+++ b/docs/source/api/v4/deliveryservice_stats.rst
@@ -77,7 +77,7 @@ Request Structure
| | | Epoch, or in the same,
proprietary format as the ``lastUpdated`` fields prevalent throughout the
Traffic Ops API
|
+---------------------+-------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-.. _deliveryservice_stats-get-request-example:
+.. _v4-deliveryservice_stats-get-request-example:
.. code-block:: http
:caption: Request Example
@@ -90,7 +90,7 @@ Request Structure
Content Format
""""""""""""""
-It's important to note in :ref:`deliveryservice_stats-get-request-example` the
use of a complex "Accept" header. This endpoint accepts two special media types
in the "Accept" header that instruct it on how to format the timestamps
associated with the returned data. Specifically, Traffic Ops will recognize the
special, optional, non-standard parameter of :mimetype:`application/json`:
``timestamp``. The values of this parameter are restricted to one of
+It's important to note in :ref:`v4-deliveryservice_stats-get-request-example`
the use of a complex "Accept" header. This endpoint accepts two special media
types in the "Accept" header that instruct it on how to format the timestamps
associated with the returned data. Specifically, Traffic Ops will recognize the
special, optional, non-standard parameter of :mimetype:`application/json`:
``timestamp``. The values of this parameter are restricted to one of
rfc
Returned timestamps will be formatted according to :rfc:`3339` (no
sub-second precision).
diff --git a/docs/source/api/v4/osversions.rst
b/docs/source/api/v4/osversions.rst
index a8581e8fc9..6e9610394c 100644
--- a/docs/source/api/v4/osversions.rst
+++ b/docs/source/api/v4/osversions.rst
@@ -33,8 +33,6 @@ Request Structure
-----------------
No parameters available.
-.. _response-structure:
-
Response Structure
------------------
This endpoint has no constant keys in its ``response``. Instead, each key in
the ``response`` object is the name of an OS, and the value is a string that
names the directory where the ISO source can be found. These directories sit
under ``/var/www/files/`` on the Traffic Ops host machine by default, or at the
location defined by the ``kickstart.files.location`` :term:`Parameter` of the
Traffic Ops server's :term:`Profile`, if it is defined.
@@ -64,7 +62,7 @@ Configuration File
The data returned from the endpoint comes directly from a configuration file.
By default, the file is located at ``/var/www/files/osversions.json``.
The **directory** of the file can be changed by creating a specific
:term:`Parameter` named ``kickstart.files.location`` in configuration file
``mkisofs``.
-The format of the file is a JSON object as described in
:ref:`response-structure`.
+The format of the file is a JSON object as described in `Response Structure`_.
.. code-block:: json
:caption: Example osversions.json file
diff --git a/docs/source/api/v5/osversions.rst
b/docs/source/api/v5/osversions.rst
index e4b4cfb589..fd42f865f0 100644
--- a/docs/source/api/v5/osversions.rst
+++ b/docs/source/api/v5/osversions.rst
@@ -33,8 +33,6 @@ Request Structure
-----------------
No parameters available.
-.. _response-structure:
-
Response Structure
------------------
This endpoint has no constant keys in its ``response``. Instead, each key in
the ``response`` object is the name of an OS, and the value is a string that
names the directory where the ISO source can be found. These directories sit
under ``/var/www/files/`` on the Traffic Ops host machine by default, or at the
location defined by the ``kickstart.files.location`` :term:`Parameter` of the
Traffic Ops server's :term:`Profile`, if it is defined.
@@ -64,7 +62,7 @@ Configuration File
The data returned from the endpoint comes directly from a configuration file.
By default, the file is located at ``/var/www/files/osversions.json``.
The **directory** of the file can be changed by creating a specific
:term:`Parameter` named ``kickstart.files.location`` in configuration file
``mkisofs``.
-The format of the file is a JSON object as described in
:ref:`response-structure`.
+The format of the file is a JSON object as described in `Response Structure`_.
.. code-block:: json
:caption: Example osversions.json file