Include files for "get the configuration" section

Author: ccarouge

docs/includes/payu.md

@@ -93,14 +93,15 @@ After joining the _vk83_ project, load the _payu_ module:
     module load payu
 
 To check that _payu_ is available, run:
-
+ø
     payu --version
 <!--end:access-payu-->
 
 ## Run an experiment
 
 ### Get the model configuration
 
+<!--start:get-config-payu-->
 All model configurations are hosted in a GitHub repository where each configuration is maintained in its own branch.<br>
 
 To get a local copy of a configuration, you need to:
@@ -111,7 +112,9 @@ To get a local copy of a configuration, you need to:
 - Choose a name for your experiment, `<local-branch>`. It is recommended to choose a descriptive name, specific to your experiment. Note that the experiment name will be formed using the _control_ directory's name and this `<local-branch>` name.
 
 Then, you can get the chosen configuration using `payu clone`.
+<!--end:get-config-payu-->
 
+<!--start:payu-clone-example-->
 For example, if you want to do a sensitivity experiment about diffusivity in ACCESS-OM2 using the configuration `release-1deg_jra55_ryf`. You decide the following:
 
 - `<repository>` and `<branch>`: base your experiment off the branch, `release-1deg_jra55_ryf`, from the repository, `https://github.com/ACCESS-NRI/access-om2-configs`

docs/models/run_a_model/run_access-esm.md

@@ -60,14 +60,14 @@ All {{model}} configurations are open source, licensed under [CC BY 4.0](https:/
 
 ## Workflow manager, _payu_
 
-??? abstract What is _payu_ and how are the simulation files organised by _payu_
+??? abstract "What is _payu_ and how are the simulation files organised by _payu_"
     {%
         include-markdown "includes/payu.md"
         start="<!--start:about-->"
         end="<!--end:about-->"
     %}
 
-??? abstract Accessing _payu_
+??? abstract "Accessing _payu_"
 
     {%
         include-markdown "includes/payu.md"
@@ -82,28 +82,15 @@ All {{model}} configurations are open source, licensed under [CC BY 4.0](https:/
 All released {{ model }} configurations are available from the [{{ model }} configs]({{github_configs}}) GitHub repository.<br>
 Released configurations are tested and supported by ACCESS-NRI, as an adaptation of those originally developed by [CSIRO](https://www.csiro.au/en/research/environmental-impacts/climate-change/climate-science-centre) and [CLEX CMS](https://github.com/coecms/access-esm).
 
-For more information on {{ model }} configurations, check [{{model}}][model configurations] page.
-
-More information about the available experiments and the naming scheme of the branches can also be found in the [{{ model }} configs]({{github_configs}}) GitHub repository.
-
-The first step is to choose a configuration from those available.<br>
-
-For example, if the required configuration is the co2 concentration driven pre-industrial configuration, then the branch to select is [`release-preindustrial+concentrations`](https://forum.access-hive.org.au/t/access-esm1-5-release-information/2352).
-
-To clone this branch to a location on _Gadi_, run:
-    
-    mkdir -p ~/access-esm1.5
-    cd ~/access-esm1.5
-    payu clone -b expt -B release-preindustrial+concentrations {{ github_configs }} preindustrial+concentrations
+{%
+    include-markdown "includes/payu.md"
+    start="<!--start:get-config-payu-->"
+    end="<!--end:get-config-payu-->"
+%}
 
 !!! tip
     If you want to restart your experiment from a specific restart point, please refer to [Start the run from a specific restart file](#specific-restart).
 
-In the example above the `payu clone` command clones the concentration driven pre-industrial configuration (`-B release-preindustrial+concentrations`) 
-to a new experiment branch (`-b expt`) to a directory named `preindustrial+concentrations`.
-
-!!! admonition tip
-    Anyone using a configuration is advised to clone only a single branch (as shown in the example above) and not the entire repository.
 
 <terminal-window>
     <terminal-line data="input">mkdir -p ~/access-esm1.5</terminal-line>