Improve reload docs + couple small fixes (#399)

* Improve reload docs

* Fix mistakes in caveats page

Author: MetRonnie

src/7-to-8/caveats.rst

@@ -11,7 +11,8 @@ Cylc Flow
 Trigger Edit
    Functionality removed pending reimplementation.
 
-   * https://github.com/cylc/cylc-flow/issues/3743
+   * https://github.com/cylc/cylc-flow/issues/3751
+
 Reflow
    The new "reflow" functionality, which allows multiple
    (potentially concurrent) executions of the same workflow in a single
@@ -33,7 +34,7 @@ Graph View
 
 Static Graph Visualization
    Not yet reimplemented for Cylc 8. As an interim measure the
-   ``cylc graph``` command can generate a basic PNG image of a workflow
+   ``cylc graph`` command can generate a basic PNG image of a workflow
    graph if Graphviz is installed in the Cylc environment.
 
 Log Files

src/user-guide/running-workflows/scheduler-start-up.rst

@@ -130,8 +130,12 @@ workflow configuration at run time. This is an alternative to shutting a
 workflow down and restarting it after making changes.
 
 .. note::
-   Before reload, be sure to :ref:`reinstall <Reinstalling a workflow>` your
-   changes from source to run directory
+   If writing your workflows in a :term:`source directory`, then be sure to
+   :ref:`reinstall <Reinstalling a workflow>` your changes to the
+   :term:`run directory` before doing a reload.
+
+If you make an error in the ``flow.cylc`` file before a reload, the workflow
+log will report an error and the reload will have no effect.
 
 
 Restarting or Reloading after Graph Changes