Skip to content

Commit

Permalink
Deploying to gh-pages from @ dccb9f8 🚀
Browse files Browse the repository at this point in the history
  • Loading branch information
crgoddard committed Nov 20, 2024
1 parent 7bd4ab7 commit 92a82f0
Show file tree
Hide file tree
Showing 22 changed files with 46 additions and 43 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"cells": [
{
"cell_type": "markdown",
"id": "abaf6e0e",
"id": "3f6a725b",
"metadata": {
"tags": []
},
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"cells": [
{
"cell_type": "markdown",
"id": "4ee03d51",
"id": "cf8e411d",
"metadata": {
"tags": []
},
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"cells": [
{
"cell_type": "markdown",
"id": "15584dcb",
"id": "addde992",
"metadata": {
"tags": []
},
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"cells": [
{
"cell_type": "markdown",
"id": "8a469c2e",
"id": "ba54f9dc",
"metadata": {
"tags": []
},
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"cells": [
{
"cell_type": "markdown",
"id": "72404ddd",
"id": "29ef7f6d",
"metadata": {
"tags": []
},
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"cells": [
{
"cell_type": "markdown",
"id": "ca583463",
"id": "370faf6d",
"metadata": {
"tags": []
},
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"cells": [
{
"cell_type": "markdown",
"id": "5cb6f2c0",
"id": "d5fe48dd",
"metadata": {
"tags": []
},
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"cells": [
{
"cell_type": "markdown",
"id": "06640501",
"id": "2184246d",
"metadata": {
"tags": []
},
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"cells": [
{
"cell_type": "markdown",
"id": "b148a85c",
"id": "34a9eee1",
"metadata": {
"tags": []
},
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"cells": [
{
"cell_type": "markdown",
"id": "d9d06905",
"id": "4b10dca9",
"metadata": {
"tags": []
},
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"cells": [
{
"cell_type": "markdown",
"id": "bf18ee80",
"id": "a92cbaf2",
"metadata": {
"tags": []
},
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"cells": [
{
"cell_type": "markdown",
"id": "58eafa34",
"id": "644100f4",
"metadata": {
"tags": []
},
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"cells": [
{
"cell_type": "markdown",
"id": "85b07883",
"id": "e1a6649e",
"metadata": {
"tags": []
},
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"cells": [
{
"cell_type": "markdown",
"id": "74a48a18",
"id": "045192fb",
"metadata": {
"tags": []
},
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"cells": [
{
"cell_type": "markdown",
"id": "c8bc6dd6",
"id": "9566cb2b",
"metadata": {
"tags": []
},
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"cells": [
{
"cell_type": "markdown",
"id": "dafbf692",
"id": "3cc5faa3",
"metadata": {
"tags": []
},
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"cells": [
{
"cell_type": "markdown",
"id": "d7027cf7",
"id": "e613c079",
"metadata": {
"tags": []
},
Expand Down
12 changes: 6 additions & 6 deletions _sources/templates/template.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"cells": [
{
"cell_type": "markdown",
"id": "87924d81",
"id": "60882294",
"metadata": {
"tags": []
},
Expand Down Expand Up @@ -65,7 +65,7 @@
"tags": []
},
"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)**"
]
Expand All @@ -91,9 +91,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",
"```"
]
Expand Down Expand Up @@ -528,7 +528,7 @@
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3.11.8"
"version": "3.11.10"
},
"papermill": {
"default_parameters": {},
Expand Down
14 changes: 8 additions & 6 deletions _sources/templates/template_instructions.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down Expand Up @@ -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).
Expand All @@ -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.
2 changes: 1 addition & 1 deletion searchindex.js

Large diffs are not rendered by default.

14 changes: 7 additions & 7 deletions templates/template.html
Original file line number Diff line number Diff line change
Expand Up @@ -433,7 +433,7 @@ <h2> Contents </h2>
<nav aria-label="Page">
<ul class="visible nav section-nav flex-column">
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#use-case-use-case-listed-here-in-full">🌍 Use case: Use case listed here in full</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#quality-assessment-question-s">❓ Quality assessment question(s)</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#quality-assessment-question">❓ Quality assessment question</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#quality-assessment-statement">📢 Quality assessment statement</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#methodology">📋 Methodology</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#analysis-and-results">📈 Analysis and results</a><ul class="nav section-nav flex-column">
Expand Down Expand Up @@ -487,8 +487,8 @@ <h1>Unique quality assessment title (to be finalised by C3S), including approxim
<section id="use-case-use-case-listed-here-in-full">
<h2>🌍 Use case: Use case listed here in full<a class="headerlink" href="#use-case-use-case-listed-here-in-full" title="Link to this heading">#</a></h2>
</section>
<section id="quality-assessment-question-s">
<h2>❓ Quality assessment question(s)<a class="headerlink" href="#quality-assessment-question-s" title="Link to this heading">#</a></h2>
<section id="quality-assessment-question">
<h2>❓ Quality assessment question<a class="headerlink" href="#quality-assessment-question" title="Link to this heading">#</a></h2>
<ul class="simple">
<li><p><strong>In most cases there should be one question listed here in bold</strong></p></li>
<li><p><strong>(In some cases a second related/follow-up question may be included)</strong></p></li>
Expand All @@ -500,9 +500,9 @@ <h2>📢 Quality assessment statement<a class="headerlink" href="#quality-assess
<div class="note admonition">
<p class="admonition-title">These are the key outcomes of this assessment</p>
<ul class="simple">
<li><p>Statement 1</p></li>
<li><p>Statement 2</p></li>
<li><p>Statement 3</p></li>
<li><p>Finding 1</p></li>
<li><p>Finding 2</p></li>
<li><p>Finding 3</p></li>
<li><p>etc</p></li>
</ul>
</div>
Expand Down Expand Up @@ -765,7 +765,7 @@ <h3>References<a class="headerlink" href="#references" title="Link to this headi
<nav class="bd-toc-nav page-toc">
<ul class="visible nav section-nav flex-column">
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#use-case-use-case-listed-here-in-full">🌍 Use case: Use case listed here in full</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#quality-assessment-question-s">❓ Quality assessment question(s)</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#quality-assessment-question">❓ Quality assessment question</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#quality-assessment-statement">📢 Quality assessment statement</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#methodology">📋 Methodology</a></li>
<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link" href="#analysis-and-results">📈 Analysis and results</a><ul class="nav section-nav flex-column">
Expand Down
13 changes: 7 additions & 6 deletions templates/template_instructions.html
Original file line number Diff line number Diff line change
Expand Up @@ -477,9 +477,9 @@ <h1>Template instructions<a class="headerlink" href="#template-instructions" tit
</div>
<section id="assessment-title-no-icons">
<h2>Assessment title (no icons)<a class="headerlink" href="#assessment-title-no-icons" title="Link to this heading">#</a></h2>
<p>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. <em>Seasonal forecasts bias assessment for impact models</em>.</p>
<p>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. <em>Seasonal forecasts bias assessment for impact models</em>.</p>
<ul class="simple">
<li><p><strong>Data stream</strong>: Satellite (observations), Insitu (observations), Reanalysis, Seasonal (Forecasts), Climate (projections)</p></li>
<li><p><strong>Data stream/ECV/variable</strong>: Satellite (observations), Insitu (observations), Reanalysis, Seasonal (Forecasts), Climate (projections)</p></li>
<li><p><strong>Quality area</strong>: bias, forecast skill, completeness, intercomparison of X and Y, comparison to X, trend assessment, extremes, spatial/temporal resolution, reliability, accuracy, etc.</p></li>
<li><p><strong>Application area</strong>: impact models, risk assessment, climate monitoring, scientific study of X, X sector, ‘region’, ‘specific C3S application’, flood forecasting, etc.</p></li>
</ul>
Expand Down Expand Up @@ -510,15 +510,16 @@ <h2>Context text (no heading or icon)<a class="headerlink" href="#context-text-n
</section>
<section id="quality-assessment-statement">
<h2>📢 Quality assessment statement<a class="headerlink" href="#quality-assessment-statement" title="Link to this heading">#</a></h2>
<p>Key results and guidance including an answer to the user question - to be visually highlighted and with the section title ‘Quality assessment statement’.</p>
<p>Key results and guidance including an answer to the user question.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>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.</p>
</div>
</section>
<section id="figure-no-heading-or-icon">
<h2>Figure (no heading or icon)<a class="headerlink" href="#figure-no-heading-or-icon" title="Link to this heading">#</a></h2>
<p>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 (<code class="docutils literal notranslate"><span class="pre">![](attachment:...</span> <span class="pre">ID</span> <span class="pre">from</span> <span class="pre">drag</span> <span class="pre">and</span> <span class="pre">drop)</span></code>). 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.</p>
<p>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.</p>
<p>If the image file already includes a figure number and the caption then simple syntax can be used (<code class="docutils literal notranslate"><span class="pre">![](attachment:...</span> <span class="pre">ID</span> <span class="pre">from</span> <span class="pre">drag</span> <span class="pre">and</span> <span class="pre">drop)</span></code>). 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.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>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).</p>
Expand All @@ -539,8 +540,8 @@ <h2>📈 Analysis and results<a class="headerlink" href="#analysis-and-results"
</section>
<section id="i-if-you-want-to-know-more">
<h2>ℹ️ If you want to know more<a class="headerlink" href="#i-if-you-want-to-know-more" title="Link to this heading">#</a></h2>
<p>Including a key resources subsection, which can link to suggested further reading, code packages used, and the relevant CDS catalogue entries.</p>
<p>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.</p>
<p>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.</p>
<p>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.</p>
</section>
</section>

Expand Down

0 comments on commit 92a82f0

Please sign in to comment.