minor template text tweaks (#263)

* minor template text tweaks (no resulting changes to assessment published)

* remove plural in template title for assessment question

templates/template.ipynb

@@ -47,7 +47,7 @@
    "id": "4",
    "metadata": {},
    "source": [
-    "## ❓ Quality assessment question(s)\n",
+    "## ❓ Quality assessment question\n",
     "* **In most cases there should be one question listed here in bold**\n",
     "* **(In some cases a second related/follow-up question may be included)**"
    ]
@@ -74,9 +74,9 @@
     "\n",
     "```{admonition} These are the key outcomes of this assessment\n",
     ":class: note\n",
-    "* Statement 1\n",
-    "* Statement 2\n",
-    "* Statement 3\n",
+    "* Finding 1\n",
+    "* Finding 2\n",
+    "* Finding 3\n",
     "* etc\n",
     "```"
    ]
@@ -521,7 +521,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.8"
+   "version": "3.11.10"
   },
   "papermill": {
    "default_parameters": {},

templates/template_instructions.md

@@ -24,9 +24,9 @@ There is a new approach to linking the methodology list to the subsections in an
 
 ## Assessment title (no icons)
 
-We do not aim to be completely prescriptive about the title, it should be readable and descriptive, but also include some key tags to increase searchability, e.g. *Seasonal forecasts bias assessment for impact models*.
+We do not aim to be completely prescriptive about the title, it should be readable and descriptive, but also include some keywords to increase searchability, e.g. *Seasonal forecasts bias assessment for impact models*.
 
-- **Data stream**: Satellite (observations), Insitu (observations), Reanalysis, Seasonal (Forecasts), Climate (projections)
+- **Data stream/ECV/variable**: Satellite (observations), Insitu (observations), Reanalysis, Seasonal (Forecasts), Climate (projections)
 - **Quality area**: bias, forecast skill, completeness, intercomparison of X and Y, comparison to X, trend assessment, extremes, spatial/temporal resolution, reliability, accuracy, etc.
 - **Application area**: impact models, risk assessment, climate monitoring, scientific study of X, X sector, 'region', 'specific C3S application', flood forecasting, etc.
 
@@ -56,15 +56,17 @@ A section of text with no heading which appears after the user question and befo
 
 ## 📢 Quality assessment statement
 
-Key results and guidance including an answer to the user question - to be visually highlighted and with the section title ‘Quality assessment statement’.
+Key results and guidance including an answer to the user question.
 
 ```{note}
 The blue notification box that contains the quality assessment statement bullet points will not appear in GitHub, but will be rendered when the Jupyter Book page is created.
 ```
 
 ## Figure (no heading or icon)
 
-A key figure should be included if possible, acting as a 'graphical abstract' for the assessment. This could be a figure generated later in the code, or from an external source (if licensing allows reproduction) - in this case the source should be cited in the caption. Images should be dragged and dropped into the markdown cell, which created an 'attachment code', and the external file is no longer needed. If the image file already includes a figure number and the caption then simple syntax can be used (`![](attachment:... ID from drag and drop)`). Otherwise, figure formatting can be used (see the template), where the attachment code from the drag and drop needs to be wrapped in the figure syntax. This approach should also be followed if images not generated by code are included later in the assessment.
+A key figure should be included if possible, acting as a 'graphical abstract' for the assessment. This could be a figure generated later in the code, or from an external source (if licensing allows reproduction) - in this case the source should be cited in the caption. Images should be dragged and dropped into the markdown cell, which creates an 'attachment code', and the external file is not needed.
+
+If the image file already includes a figure number and the caption then simple syntax can be used (`![](attachment:... ID from drag and drop)`). Otherwise, figure formatting can be used (see the template), where the attachment code from the drag and drop needs to be wrapped in the figure syntax. This approach should also be followed if images not generated by code are included later in the assessment.
 
 ```{note}
 The figure formatting will not render in Github, but will work when the Jupyter Book page is built. Also note that the figure numbering is automatic, and applied across the whole Book (each Notebook does not start at 1 - this may be changed in the future). 
@@ -87,6 +89,6 @@ A series of subsections with the same titles as in the listen in the methodology
 
 ## ℹ️ If you want to know more
 
-Including a key resources subsection, which can link to suggested further reading, code packages used, and the relevant CDS catalogue entries.
+Including a key resources subsection, which can link to suggested further reading, code packages used, and the relevant CDS catalogue entries. Try to link to relevant applications of the data, such as the C3S Climate Atlas, for projections, or the relevant parts of the European State of the Climate report for some ECVs.
 
-Including a references subsection, which is a numbered list of the references used throughout the text. However, the references in the text will link to the external source, rather than the references list at the bottom of the assessment.
+Including a references subsection, which is a numbered list of the references used throughout the text. However, the references in the text should link to the external source, rather than the references list at the bottom of the assessment.