Merge pull request #593 from MetRonnie/fix-db-diagram

Fix docs

Author: oliver-sanders

src/dictionaries/proper_nouns

@@ -19,6 +19,7 @@ Heathrow
 Hoverwork
 IDL
 Jinja
+jinja
 Jupyter
 loadleveler
 lsf

src/dictionaries/words

@@ -3,7 +3,7 @@ apps
 args
 auth
 authenticator
-bar
+backticks
 baz
 boolean
 booleans

src/ext/database_diagram.py

@@ -136,7 +136,7 @@ def generate_dotcode():
         # get markdown
         with tempfile.NamedTemporaryFile() as tf_db:
             # is_public=False triggers the creation of tables
-            CylcWorkflowDAO(db_file_name=tf_db.name, is_public=False)
+            CylcWorkflowDAO(db_file_name=tf_db.name, create_tables=True)
             schema, orphans = schema_to_markdown(db_name=tf_db.name)
 
         # graph prefix

src/workflow-design-guide/efficiency.rst

@@ -346,11 +346,6 @@ Optional app configs should be valid on top of the main app config and not
 dependent on the use of other optional app configs. This ensures they will
 work correctly with macros and can therefore be upgraded automatically.
 
-.. note::
-
-   Currently optional configs don't work very well with UM STASH
-   configuration - see :ref:`UM STASH in Optional App Configs`.
-
 Optional app configs can be loaded by command line switch:
 
 .. code-block:: bash

src/workflow-design-guide/portable-workflows.rst

@@ -54,7 +54,7 @@ Site Include-Files
 
 If a section heading in a :cylc:conf:`flow.cylc` file is repeated the items
 under it simply add to or override those defined under the same section earlier
-in the file (but note :ref:`List Item Override In Site Include-Files`).
+in the file.
 For example, this task definition:
 
 .. code-block:: cylc