Title of the tutorial

Overview

Timings

• Teaching: X min

• Exercises: Y min

Questions

• Describe what the learner will accomplish.

• Question 1?

• Question 2?

Learning outcomes

• Describe the learning outcomes, i.e. the knowledge, skills, or expertise the learner will gain.

• Objective 1.

• Objective 2.

Prerequisites

• Provide any prerequisites.

• Prerequisites 1.

• Prerequisites 2.

Assumptions

• Provide any assumptions.

• Assumption 1.

• Assumption 2.

Question 1

Add content here.

• Consider including diagrams to support the text.

• Use any free icons from Font Awesome via an :fa: directive.

• Use admonitions from PyData Theme documentation: Admonitions.

• Link to other files within the documentation:

  • Link to pages via :doc:`/develop/recipe` (renders as Recipe).

  • Link to sections via :ref:`diagnostic_from_example` (renders as Creating a recipe and diagnostic script(s)).

• Include other files within the documentation:

  2026-05-11 15:22:20,686 UTC [280110] INFO
  ______________________________________________________________________
            _____ ____  __  ____     __    _ _____           _
           | ____/ ___||  \/  \ \   / /_ _| |_   _|__   ___ | |
           |  _| \___ \| |\/| |\ \ / / _` | | | |/ _ \ / _ \| |
           | |___ ___) | |  | | \ V / (_| | | | | (_) | (_) | |
           |_____|____/|_|  |_|  \_/ \__,_|_| |_|\___/ \___/|_|
  ______________________________________________________________________
  
  Earth System Model Evaluation Tool
  
  A community tool for the evaluation of Earth system models.
  
  https://esmvaltool.org
  
  The Earth System Model Evaluation Tool (ESMValTool) is a community
  diagnostics and performance metrics tool for the evaluation of Earth
  System Models (ESMs) that allows for routine comparison of single or
  multiple models, either against predecessor versions or against
  observations.
  
  Tutorial: https://tutorial.esmvaltool.org
  Documentation: https://docs.esmvaltool.org
  Contact: esmvaltool-dev@listserv.dfn.de
  
  If you find this software useful for your research, please cite it using
  https://doi.org/10.5281/zenodo.3387139 for ESMValCore or
  https://doi.org/10.5281/zenodo.3401363 for ESMValTool or
  any of the reference papers listed at https://esmvaltool.org/references/.
  
  Have fun!
  

Question 2

Add content here.

• Use code snippets:

  Listing 1 Bash

  my command
  

  Listing 2 Python

  with line numbers
  and code highlighting
  

• Create expandable sections containing the output / answer / solution from a command:

  Output

  Listing 3 Bash

  my output
  

The language of tutorials

We …

The first-person plural affirms the relationship between tutor and learner: you are not alone; we are in this together.

First, do x. Now, do y. Now that you have done y, do z.

No room for ambiguity or doubt.

We must always do x before we do y. <explanation> provides more details.

Provide minimal explanation of actions in the most basic language possible. Link to more detailed explanation.

The output should be something like …

Give your learner clear expectations.

Notice that … Remember that … Let’s check …

Give your learner plenty of clues to help confirm they are on the right track and orient themselves.

Congratulations!

You have built a secure, three-layer hylomorphic stasis engine …

Describe (and admire, in a mild way) what your learner has accomplished.

Key points

• Key point 1

• Key point 2