initiate examples pages

docs/fillindian.rst

@@ -0,0 +1,4 @@
+Fill Indian Ocean
+=================
+
+Instructions coming soon...

docs/index.rst

@@ -53,3 +53,10 @@ For more information on each step, please refer to the corresponding sections in
    grid
    launch
    troubleshooting
+
+.. toctree::
+   :maxdepth: 3
+   :caption: Examples:
+
+   ridge
+   fillindian

docs/open.rst

@@ -1,3 +1,5 @@
+.. _Open:
+
 Opening the GUI
 ===============================
 

docs/ridge.rst

@@ -0,0 +1,78 @@
+Ridge World
+==============================
+
+This example provides step-by-step guidance on how to generate a coupled idealized
+configuration that consists of an aquaplanet with land caps at the pole and a narrow
+land ridge extending between the two poles, similar to the configuration used in `Wu et al (2021) <https://agupubs.onlinelibrary.wiley.com/doi/full/10.1029/2021GL093966>`_ .
+In the example given below, the visualCaseGen GUI is used to guide users through choosing
+their CESM components, setting up all the ocean input files, setting up all the land input
+files, and finally setting up and configuring their case.
+
+Here we are not running a standard case with CESM.  We are modifying the configuration substantially by changing the ocean grid, ocean bathymetry, continental geometry and land surface properties, so you should select "Custom" here.
+
+
+Stage 0: Open visualCaseGen
+--------------------------
+
+Follow the instructions in the :ref:`Open` to open visualCaseGen in your Jupyter notebook environment.
+
+Stage 1: Select Compset
+----------------------
+
+After having executed the cell with the command `from visualCaseGen import gui; gui`,
+and clicking the **Start** button, you will see the main interface of visualCaseGen. 
+
+Click the **Custom** button to proceed with creating a custom compset for our idealized
+Ridge World configuration.
+
+.. image:: assets/stage1_1.png
+
+Initialization time
+~~~~~~~~~~~~~~~~~~~
+
+Once the `Custom` button is clicked, you will be prompted to select the initialization time.
+For this example, we will select `1850`` as the initialization time.
+
+.. image:: assets/stage1_5.png
+
+
+Models
+~~~~~~
+
+Once you've selected the initialization time, visualCaseGen will prompt you to select the
+models for each component class. In this ridge world case we select the following component options:
+`cam` as the atmosphere;
+`clm`` as the land component; `cice`` as the ice component; `mom`` as the ocean component, `srof`` 
+(i.e., stub run off) as the river component; `sglc`` (i.e., stub land ice) as the land ice component;
+and, `swav` (i.e. stub wave) as the wave component. After all the selections are made, the 
+model matrix should look like:
+
+.. image:: assets/ridge1.png
+
+Model Physics
+~~~~~~~~~~~~~
+
+Having selected the models, you will proceed to select the physics options for each. The physics
+settings determine the complexity of each model component and impact computational requirements.
+For this example, we will select the following physics options which are based on the selections
+made in `Wu et al (2021) <https://agupubs.onlinelibrary.wiley.com/doi/full/10.1029/2021GL093966>`_ :
+
+.. image:: assets/ridge2.png
+
+Component Options (Modifiers)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+We are now ready to finalize the compset by selecting optional physics modifiers. For this example,
+we will select `(none)` for all the components except for the `clm` component where we will select
+the satellite phenology (SP) mode for the land which means that aspects of the land model such as
+leaf-area index are prescribed as opposed to being prognosed interactively by the land biogeochemistry.
+
+.. image:: assets/ridge3.png
+
+Stage 2: Grid
+----------------------
+Having completed the compset configuration, you will now proceed to the `Grid` stage ...
+
+Further instructions will be added as the example is developed...
+
+