Rewrite how to run ACCESS-ESM1.5 according to feedback from user experience

docs/css/access-nri.css

@@ -1234,6 +1234,17 @@ img.terminal-switch:hover ~ .terminal-switch-tooltip {
 .git-cyan {
     color: #00C6C7;
 }
+.payu-yellow {
+  color:#ecff1e;
+}
+.payu-red {
+  color: #b78683;
+}
+.payu-dark-yellow {
+  color: #f9bd26;
+}
+
+
 
 /* =============================================================== 
   General styling for html tabs

docs/includes/terminology.md

@@ -0,0 +1,17 @@
+<!--start:terminology-conf-vs-exp-->
+### _Configuration_ and _experiment_ definitions
+
+The terms _configuration_ and _experiment_ are not interchangeable although they are closely related.
+
+- A _configuration_ defines a specific way to run the model it relates to.<br> 
+  A configuration is defined by:
+
+     - model version and build (model executable(s))
+     - set of input files (ancillaries, forcings, restarts)
+     - set of physical and modelling options for each model component, such as namelists, configuration files and MPI layout
+
+    Changing any one of these elements creates a new configuration
+
+- An _experiment_ is a realisation of a configuration: a series of sequential runs that generate model data over a span of model time.
+<!--start:terminology-conf-vs-exp-->
+

docs/models/run_a_model/index.md

@@ -22,6 +22,27 @@ If you are unsure which ACCESS model is the best fit for your application, you c
             Run ACCESS-CM2
         </div>
     </a>
+    <!-- Run ACCESS-rAM -->
+    <a href="run_access-ram3" class="vertical-card aspect-ratio1to1">
+        <div class="card-image-container">
+            <img class="img-contain with-padding white-background" src="/assets/model-config-logos/model_visualisation/access_ram_model_visualisation.png" alt="ACCESS-rAM">
+        </div>
+        <div class="card-text-container bold">   
+            Run ACCESS-rAM3
+        </div>
+    </a>
+</div>
+
+<div class="card-container">
+    <!-- Payu -->
+    <a href="/models/run_a_model/payu" class="vertical-card aspect-ratio1to1">
+        <div class="card-image-container">
+            <img class="img-contain with-padding white-background" src="/assets/rose_cylc_logo.png" alt="Run models using Payu">
+        </div>
+        <div class="card-text-container bold">   
+            Run models using Payu
+        </div>
+    </a>
     <!-- Run ACCESS-ESM -->
     <a href="run_access-esm" class="vertical-card aspect-ratio1to1">
         <div class="card-image-container">
@@ -49,13 +70,4 @@ If you are unsure which ACCESS model is the best fit for your application, you c
             Run ACCESS-OM3
         </div>
     </a>
-    <!-- Run ACCESS-rAM -->
-    <a href="run_access-ram3" class="vertical-card aspect-ratio1to1">
-        <div class="card-image-container">
-            <img class="img-contain with-padding white-background" src="/assets/model-config-logos/model_visualisation/access_ram_model_visualisation.png" alt="ACCESS-rAM">
-        </div>
-        <div class="card-text-container bold">   
-            Run ACCESS-rAM3
-        </div>
-    </a>
 </div>

mkdocs.yml

@@ -71,6 +71,7 @@ plugins:
         'models/run_a_model/run_access-ram.md': 'models/run_a_model/run_access-ram3.md'
   - resolve-absolute-urls
   - macros
+  - include-markdown
 
 # Extensions
 markdown_extensions:
@@ -137,10 +138,11 @@ nav:
       - models/run_a_model/index.md
       - Run models using Rose/Cylc: models/run_a_model/rose_cylc.md
       - Run ACCESS-CM2: models/run_a_model/run_access-cm2.md
+      - Run ACCESS-rAM3: models/run_a_model/run_access-ram3.md
+      - Run models using Payu: models/run_a_model/payu.md
       - Run ACCESS-ESM1.5: models/run_a_model/run_access-esm.md
       - Run ACCESS-OM2: models/run_a_model/run_access-om2.md
       - Run ACCESS-OM3: models/run_a_model/run_access-om3.md
-      - Run ACCESS-rAM3: models/run_a_model/run_access-ram3.md
     - Build a Model:
       - models/build_a_model/index.md
       - Modify and build an ACCESS model's source code: models/build_a_model/build_source_code.md

requirements.txt

@@ -4,3 +4,4 @@ mkdocs-macros-plugin==1.3.7
 mkdocs-bibtex==4.4.0
 git+https://github.com/ACCESS-NRI/mkdocs_resolve_absolute_urls_plugin.git@1.3.0
 mkdocs-redirects==1.2.2
+mkdocs-include-markdown-plugin