Unify link targets text (#199)

* Unify link targets text * Update ExampleTexts.rst Added indexes, changed wording to proper plural Co-authored-by: Lina Wolf <48202465+linawolf@users.noreply.github.com>
TYPO3-Documentation · Jan 24, 2021 · e1be80f · e1be80f
1 parent 49f8282
commit e1be80f
Show file tree

Hide file tree

Showing 3 changed files with 21 additions and 12 deletions.
diff --git a/Documentation/GeneralConventions/ExampleTexts.rst b/Documentation/GeneralConventions/ExampleTexts.rst
@@ -131,6 +131,20 @@ These are some changes that we made for the following reasons:
 
 See `decision: Proposal for documentation manual start page <https://decisions.typo3.org/t/proposal-for-documentation-manual-start-page/668>`__
 
+.. index:: 
+   Documentation; Link targets
+   Files; Targets.rst
+
+Link targets
+============
+
+Official documentation manuals should contain a file :file:`Documentation/Targets.rst`
+with the following content:
+
+.. literalinclude:: ../Targets.rst
+   :language: rst
+
+
 .. exapmle-menu::
 
 Menu

diff --git a/Documentation/Settings.cfg b/Documentation/Settings.cfg
@@ -62,7 +62,7 @@ project_repository   = https://github.com/TYPO3-Documentation/TYPO3CMS-Guide-How
 # official manuals
 # ----------------
 
-# h2document     = https://docs.typo3.org/m/typo3/docs-how-to-document/master/en-us/
+h2document     = https://docs.typo3.org/m/typo3/docs-how-to-document/master/en-us/
 t3contribute   = https://docs.typo3.org/m/typo3/guide-contributionworkflow/master/en-us/
 t3coreapi      = https://docs.typo3.org/m/typo3/reference-coreapi/master/en-us/
 t3docteam      = https://docs.typo3.org/m/typo3/team-t3docteam/master/en-us/

diff --git a/Documentation/Targets.rst b/Documentation/Targets.rst
@@ -2,23 +2,18 @@
 
 .. include:: /Includes.rst.txt
 
-.. only:: html
-
-.. _labels-for-crossreferencing:
 .. _linktargets:
 
-
-Targets for Cross-Referencing
-=============================
+Link targets
+============
 
 .. hint::
 
    This page is only relevant for documentation contributors!
 
-For an explanation of cross-referencing, see :ref:`intersphinx`.
-
-The following is a list of all :ref:`link targets <link-targets-explanation>`
-defined in this manual.
-
+This page contains an automatically generated list of all
+:ref:`link targets <h2document:link-targets-explanation>`
+in this manual. It can be used for cross-referencing within this manual
+and from other manuals using :rst:`:ref:`.
 
 .. ref-targets-list::