Remove demo page as notebook page replaces that

Author: tomdurrant

docs/usage.md

@@ -1,15 +1,20 @@
 # Usage
 
-Rompy provides a framework for ocean model configuration and setup. Here are some usage examples:
+This section has been consolidated into other documentation pages. Please refer to these sections for comprehensive usage information:
 
-## Basic Model Run
+## Getting Started
 
-```python
-from rompy import ModelRun
+- [**User Guide**](user_guide.md) - Complete tutorial from installation to running your first model
+- [**Quickstart**](quickstart.md) - Basic example to quickly get up and running
 
-# Create a model run instance
-run = ModelRun()
+## Tutorials & Examples
 
-# Execute the model run
-run()
-```
+- [**Progressive Tutorials**](progressive_tutorials.md) - Step-by-step tutorials building from basic to advanced usage
+- [**Practical Examples**](examples.md) - Real-world scenarios with complete code examples
+- [**Common Workflows**](common_workflows.md) - Typical ocean modeling workflows and best practices
+
+## Configuration & Backends
+
+- [**Configuration Deep Dive**](configuration_deep_dive.md) - Detailed configuration options and best practices
+- [**Backends**](backends.md) - Execution backends for different environments
+- [**Core Concepts**](core_concepts.md) - Key abstractions and design patterns

mkdocs.yml

@@ -36,7 +36,6 @@ nav:
           - Backend Reference: developer/backend_reference.md
     - API Reference: api.md
     - FAQ: faq.md
-    - Demo: demo.md
     - Demonstration Notebooks:
           - Rompy core: notebooks/common/rompy_core_features.ipynb
           - SWAN:
@@ -46,7 +45,8 @@ nav:
                       - boundnest1: notebooks/swan/boundary/boundnest1.ipynb
                       - boundspec_segment: notebooks/swan/boundspec_segment.ipynb
                       - boundspec_side: notebooks/swan/boundary/boundspec_side.ipynb
-          - SCHISM: notebooks/schism/schism_demo.ipynb
+          - SCHISM:
+                - notebooks/schism/schism_demo.ipynb
           - XBEACH:
                 - Basic: notebooks/xbeach/example_procedural.ipynb
                 - Grid: notebooks/xbeach/forcing-demo.ipynb
@@ -55,7 +55,10 @@ nav:
                 - Grid expanding: notebooks/xbeach/grid-expanding.ipynb
                 - Wave boundary: notebooks/xbeach/grid-expanding.ipynb
                 - Bathy boundary: notebooks/xbeach/grid-expanding.ipynb
-          - backends: notebooks/backends/backend_examples.ipynb
+          - backends:
+                - notebooks/backends/backend_examples.ipynb
+    # - Gallery:
+    #       - Generated Examples: generated/gallery/index.md
 
 theme:
     name: material
@@ -87,7 +90,7 @@ theme:
 plugins:
     - search
     - mkdocs-jupyter:
-          execute: true
+          execute: false
           execute_ignore:
               - "*.ipynb"
           include_source: True
@@ -111,8 +114,13 @@ plugins:
                       filters:
                           - "!^_" # Hide private members by default
     # - gallery:
-    #       examples_dirs: examples/notebooks # path to your example scripts
-    #       gallery_dirs: docs/generated/gallery # where to save generated gallery
+    #       examples_dirs:
+    #           - examples/notebooks/rompy_notebooks/common
+    #           - examples/notebooks/rompy_notebooks/backends
+    #           - examples/notebooks/rompy_notebooks/swan
+    #           - examples/notebooks/rompy_notebooks/schism
+    #       gallery_dirs:
+    #           - docs/generated/gallery # where to save generated gallery
 
 markdown_extensions:
     - pymdownx.highlight: