Merge pull request #912 from MetRonnie/small-fix

Replace generic links to the user guide

Author: samuel-denton

src/conf.py

@@ -200,6 +200,8 @@ def generate_task_icon_modifier_rst():
     # linkcheck has trouble handling GH anchors
     'https?://github.com/.*#.*',
     'https?://matrix.to/.*#.*',
+    # Blocked by bot protection:
+    'https?://www.iso.org',
 ]
 
 # -- Options for Slides output ----------------------------------------------

src/hyperlinks.rst.include

@@ -3,7 +3,6 @@
 .. _Apollo Client: https://www.apollographql.com/docs/react/
 .. _Configurable HTTP Proxy: https://github.com/corridor/configurable-http-proxy
 .. _CurveZMQ: http://curvezmq.org/page:read-the-docs
-.. _Cylc User Guide: https://cylc.github.io/cylc-doc/latest/html/index.html
 .. _Cylc Workflow Design Guide: https://cylc.github.io/cylc-doc/latest/html/workflow-design-guide/index.html
 .. _Cylc: https://cylc.github.io/
 .. _Cylc Discourse Forum (7-to-8 topic): https://cylc.discourse.group/c/cylc/7-to-8/13

src/tutorial/furthertopics/clock-triggered-tasks.rst

@@ -172,4 +172,4 @@ Summary
 * Clock triggers are a built in example of :ref:`Section External Triggers`.
 * Clock triggers can only be used in datetime cycling workflows.
 
-For more information see the `Cylc User Guide`_.
+For more information see the :ref:`Cylc User Guide <Built-in Clock Triggers>`.

src/tutorial/furthertopics/message-triggers.rst

@@ -27,7 +27,7 @@ complete.
 We could also set up :term:`message triggers <message trigger>` to, for example,
 send an email to inform us that a submission has failed, making use of Cylc's
 task event handling system. More information is available on these in the
-`Cylc User Guide`_.
+:ref:`Cylc User Guide <MessageTriggers>`.
 
 
 :term:`Message triggers <message trigger>` provide a superior solution to

src/tutorial/furthertopics/queues.rst

@@ -116,4 +116,4 @@ The customers will obviously have to wait!
 Further Reading
 ---------------
 
-For more information, see the `Cylc User Guide`_.
+For more information, see the :ref:`Cylc User Guide <InternalQueues>`.

src/tutorial/runtime/configuration-consolidation/families.rst

@@ -151,7 +151,7 @@ Graphing
       Run as soon as all of the family members have completed (i.e. have each
       either succeeded or failed).
 
-   For more information on family triggers see the `Cylc User Guide`_.
+   For more information on family triggers see the :ref:`Cylc User Guide <FamilyTriggers>`.
 
 .. ifslides::
 

src/tutorial/runtime/configuration-consolidation/parameters.rst

@@ -177,7 +177,7 @@ Parameters can be either strings or integers:
 
 .. ifnotslides::
 
-   For more information see the `Cylc User Guide`_.
+   For more information see the :ref:`Cylc User Guide <User Guide Param>`.
 
 .. ifslides::
 

src/tutorial/scheduling/datetime-cycling.rst

@@ -232,9 +232,8 @@ cycle point by:
 
 * Using an `inferred recurrence`_ instead (i.e. ``T00``).
 * Overriding the recurrence start point (i.e. ``T00/P1D``)
-* Using ``[scheduling]initial cycle point constraints`` to
-  constrain the initial cycle point (e.g. to a particular time of day). See
-  the `Cylc User Guide`_ for details.
+* Using :cylc:conf:`[scheduling]initial cycle point constraints` to
+  constrain the initial cycle point (e.g. to a particular time of day).
 
 The Initial and Final Cycle Points
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

src/tutorial/scheduling/further-scheduling.rst

@@ -50,7 +50,8 @@ to handle events within your code (custom outputs).
 
 .. ifnotslides::
 
-   *For more information see the* `Cylc User Guide`_.
+   For more information see the :ref:`Cylc User Guide <TriggerTypes>`.
+
 
 
 .. _tutorial-clock-triggers:

src/workflow-design-guide/index.rst

@@ -22,8 +22,8 @@ workflows), and end with some pointers to future developments.
 
    A good working knowledge of Cylc and Rose is assumed. For further details,
    please consult the:
- 
-   - `Cylc User Guide`_
+
+   - :ref:`Cylc User Guide <user guide>`
    - `Rose Documentation`_
 
 .. note::