Merge pull request #690 from ACCESS-NRI/development

Periodical merge

README.md

@@ -29,7 +29,7 @@ Please follow the guidelines below to make the Hive consistent among all the pag
 
 ### Styling Markdown using CSS
 #### Attribute lists
-To style Markdown using custom CSS, you can use [attribute lists](https://python-markdown.github.io/extensions/attr_list/#limitations) by adding the desired CSS style (in-line or adding classes as defined in the `access-nri.css` file) inside curly brackets (starting with a colon) right after the markdown syntax.
+To style Markdown using custom CSS, you can use [attribute lists](https://python-markdown.github.io/extensions/attr_list/) by adding the desired CSS style (in-line or adding classes as defined in the `access-nri.css` file) inside curly brackets (starting with a colon) right after the markdown syntax.
 
 For example, to make an image 50%-wide and with rounded borders, you can write the following:
 ```

docs/about/contact.md

@@ -10,7 +10,7 @@ Check the [User Support page](/about/user_support) if you need help, and for inf
 
 Join the [ACCESS-Hive Community Forum](https://forum.access-hive.org.au/) and find related discussions about the resources listed here, or start your own and make contacts with your community.
 
-## Places where you can find the ACCESS-NRI team
+## Get in contact with the ACCESS-NRI team
 
 :fontawesome-brands-discourse: [ACCESS-Hive Community Forum](https://forum.access-hive.org.au/)
 
@@ -19,7 +19,5 @@ Join the [ACCESS-Hive Community Forum](https://forum.access-hive.org.au/) and fi
 :fontawesome-brands-twitter: [ACCESS-NRI Twitter](https://twitter.com/ACCESS_NRI)
 
 :fontawesome-brands-linkedin: [ACCESS-NRI LinkedIn](https://www.linkedin.com/in/access-nri)
-
-:fontawesome-brands-slack: [ACCESS-NRI Slack channel](https://access-nri.slack.com)
 
 [^1]: _"Contact" image source_: [Image by pch.vector](https://www.freepik.com/free-vector/contact-concept-landing-page_5155590.htm#page=5&query=contact%20cartoon&position=6&from_view=search&track=ais) on Freepik

docs/community_resources/external_resources.md

@@ -0,0 +1,19 @@
+# External Resources
+
+ ACCESS-NRI is a constantly growing community! There are external tutorials, references, articles, projects and tools, related to ACCESS-NRI and its documentation hub, ACCESS-Hive.
+
+ Here's a list of interesting articles and links, constantly updated as relevant external resources are found: 
+
+ <div class="card-container">
+     <a href="https://www.climatechange.ai" target="_blank" class="horizontal-card">
+         <div class="card-image-container">
+             <img src="/assets/climate-change-ai.jpg" class="white-background"></img> 
+         </div>
+         <div class="card-text-container">
+             <span class="bold">Climate Change AI</span>
+             <span>
+                 Intersection of Climate Change and Machine Learning
+             </span>
+         </div>
+     </a>
+ </div>

docs/community_resources/index.md

@@ -27,6 +27,12 @@
         </div>
         <div class="card-text-container bold">Model Evaluation Links</div>
     </a>
+    <a href="/community_resources/external_resources" class="vertical-card aspect-ratio1to1">
+         <div class="card-image-container">
+             <img class="img-cover" src="/assets/external-links.jpg" alt="External Resources and Links">
+         </div>
+         <div class="card-text-container bold">External Resources</div>
+     </a>
     <a href="/community_resources/glossaries" class="vertical-card aspect-ratio1to1">
         <div class="card-image-container">
             <img class="img-cover" src="/assets/glossary.png" alt="Glossaries">

docs/models/model_components/land.md

@@ -15,11 +15,19 @@ CABLE provides the land surface component of [ACCESS-CM](/models/configurations/
 Directly coupled into the [UM](/models/model_components/atmosphere#unified-model-um), CABLE replaces relevant parts of the functionality of the UM’s own land surface scheme ([JULES](#jules)).<br>
 CABLE can also be run as a standalone model, for a single location, a region or globally.
 
-### benchcab: evaluation tool for CABLE
+### Benchcab: evaluation tool for CABLE
 
-<a href="https://benchcab.readthedocs.io/en/stable/" target="_blank">benchcab</a> is a testing framework tool for CABLE. It allows to test CABLE's scientific performance across a range of model configurations and model versions. The tool currently tests CABLE offline only with flux site simulations, using observed eddy covariance data and with spatial simulations over a region or globally. The output of these simulations can then be uploaded to <a href="https://modelevaluation.org/" target="_blank">modelevaluation.org</a> for a statistical analysis of the scientific performance of the supplied configurations.
+[_Benchcab_](https://benchcab.readthedocs.io/en/stable) is a testing framework tool for CABLE. It allows to test CABLE's scientific performance across a range of model configurations and model versions.<br>
+The tool currently works with the following configurations for CABLE:
 
-We invite you to refer to <a href="https://benchcab.readthedocs.io/en/stable/" target="_blank">the documentation</a> to know how to use the tool and learn about current limitations to the functionalities.
+- **Flux site simulations (offline)**<br>
+  running CABLE forced with observed eddy covariance data at a single site
+- **Global/regional simulations (offline)**<br>
+  running CABLE forced with meteorological fields, globally or over a region
+
+The output of these simulations can then be uploaded to [modelevaluation.org](https://modelevaluation.org/) for a statistical analysis of the scientific performance of the supplied configurations.
+
+To learn more about _benchcab_, its functionalities and limitations, refer to [_benchcab_'s documentation](https://benchcab.readthedocs.io/en/stable/).
 
 ## JULES
 

docs/models/run-a-model/run-access-esm.md

@@ -1,6 +1,12 @@
 {% set model = "ACCESS-ESM" %}
 [PBS job]: https://opus.nci.org.au/display/Help/4.+PBS+Jobs
 
+!!! bug
+    There is a known issue with the {{ model }} configurations currently set up in the GitHub repository below.
+    {{ model }} configurations are currently being updated and an ACCESS-NRI release will come
+    in the following weeks.
+    If you encounter problems with the current guide in this page, consider asking for help on the [ACCESS-Hive Forum](https://forum.access-hive.org.au).
+
 # Run {{ model }}
 
 ## Prerequisites

mkdocs.yml

@@ -71,9 +71,6 @@ plugins:
 markdown_extensions: 
   - attr_list
   - abbr
-  - pymdownx.emoji:
-      emoji_index: !!python/name:materialx.emoji.twemoji
-      emoji_generator: !!python/name:materialx.emoji.to_svg
   - md_in_html
   - admonition
   - pymdownx.details
@@ -82,12 +79,16 @@ markdown_extensions:
   - pymdownx.caret
   - pymdownx.mark
   - pymdownx.tilde
+  - pymdownx.snippets
+  - pymdownx.emoji:
+      emoji_index: !!python/name:materialx.emoji.twemoji
+      emoji_generator: !!python/name:materialx.emoji.to_svg
   - pymdownx.tabbed:
       alternate_style: true 
+  - pymdownx.keys
   - def_list
   - footnotes
   - tables
-  - pymdownx.keys
   - toc:
       title: On this page
 
@@ -176,6 +177,7 @@ nav:
       - Model Catalogues: community_resources/community_med/community_model_catalogs.md
       - Data Formatting: community_resources/community_med/community_data_processing.md
       - Evaluation Recipes: community_resources/community_med/community_med_recipes.md
+    - External Resources: community_resources/external_resources.md
     - Glossaries: community_resources/glossaries.md
     # - Training: 
     #   - Training: drafts/training/index.md