Improve user journey navigation across the site

- Fix 4 broken internal links (missing /stepss-docs base path)
- Update landing page: replace developer-heavy quick links with
  Model Reference and Test Systems; change secondary CTA to Browse Examples
- Add 'Next Steps' cross-navigation to 10 key pages guiding users
  through the natural flow: Overview → Install → Quick Start →
  File Formats → Network → PFC → Reference Frames → Dynamic Models →
  Disturbances → Solver → PyRAMSES → Test Systems
- Merge thin 'Analysis' sidebar section into 'Dynamic Simulation'
  (eigenanalysis is part of the simulation workflow)

Author: apetros

src/content/docs/developer/user-models.md

@@ -406,3 +406,9 @@ After writing a model file, CODEGEN translates it into Fortran 2003 code. The wo
 For compilation details, see [URAMSES](/stepss-docs/developer/uramses/).
 
 See the [CODEGEN Blocks Library](/stepss-docs/developer/codegen-library/) for the available modelling blocks.
+
+## Next Steps
+
+- [CODEGEN Blocks Library](/stepss-docs/developer/codegen-library/) — Reference for all modeling blocks
+- [CODEGEN Model Examples](/stepss-docs/developer/codegen-examples/) — Complete model files for each type
+- [URAMSES](/stepss-docs/developer/uramses/) — Compile and link custom models with RAMSES

src/content/docs/getting-started/overview.md

@@ -105,3 +105,8 @@ See the [Quick Start](/stepss-docs/getting-started/quickstart/) for details on e
 | **Command-line executables** | Windows and Linux (ramses, pfc) |
 | **CODEGEN compilation** | Visual Studio 2022 + Intel oneAPI Fortran |
 | **Free version limits** | 1000 buses max, 2 OpenMP cores |
+
+## Next Steps
+
+- [Installation](/stepss-docs/getting-started/installation/) — Set up STEPSS on your system
+- [Quick Start](/stepss-docs/getting-started/quickstart/) — Run your first simulation

src/content/docs/index.mdx

@@ -11,12 +11,12 @@ hero:
       link: /stepss-docs/getting-started/overview/
       icon: right-arrow
       variant: primary
-    - text: PyRAMSES API
-      link: /stepss-docs/pyramses/api-reference/
+    - text: Browse Examples
+      link: /stepss-docs/pyramses/examples/
       icon: right-arrow
 ---
 
-import { Card, CardGrid } from '@astrojs/starlight/components';
+import { Card, CardGrid, LinkCard } from '@astrojs/starlight/components';
 
 ## Core Modules
 
@@ -31,7 +31,7 @@ import { Card, CardGrid } from '@astrojs/starlight/components';
     Translates user-defined models into Fortran 2003 code for compilation and linking with RAMSES.
   </Card>
   <Card title="PyRAMSES — Python Interface" icon="seti:python">
-    Modern Python API for scripting simulations, extracting results, and integrating with the scientific Python ecosystem.
+    Python API for scripting simulations, extracting results, and integrating with the scientific Python ecosystem.
   </Card>
 </CardGrid>
 
@@ -44,10 +44,10 @@ import { Card, CardGrid } from '@astrojs/starlight/components';
   <Card title="Quick Start" icon="open-book">
     [Run your first simulation →](/stepss-docs/getting-started/quickstart/)
   </Card>
-  <Card title="User-Defined Models" icon="setting">
-    [Create custom models with CODEGEN →](/stepss-docs/developer/user-models/)
+  <Card title="Model Reference" icon="list-format">
+    [Browse available models →](/stepss-docs/models/ieee-exciters/)
   </Card>
-  <Card title="URAMSES" icon="puzzle">
-    [Compile and link Fortran models →](/stepss-docs/developer/uramses/)
+  <Card title="Test Systems" icon="star">
+    [Nordic and 5-bus benchmarks →](/stepss-docs/test-systems/nordic/)
   </Card>
 </CardGrid>

src/content/docs/pyramses/api-reference.md

@@ -813,3 +813,8 @@ pyramses.curplot([
     ext.getSync('g3').S,
 ])
 ```
+
+## Next Steps
+
+- [Examples](/stepss-docs/pyramses/examples/) — Practical simulation examples and workflows
+- [Test Systems](/stepss-docs/test-systems/nordic/) — Ready-to-run benchmark systems

src/content/docs/pyramses/examples.md

@@ -103,7 +103,7 @@ ram.addDisturb(100.0, 'BREAKER SYNC_MACH g7 0')
 ram.contSim(ram.getInfTime())
 ```
 
-For full disturbance syntax, see the [disturbances reference](/pyramses/disturbances).
+For full disturbance syntax, see the [Disturbances reference](/stepss-docs/user-guide/disturbances/).
 
 ## Plotting Results
 

src/content/docs/pyramses/installation.mdx

@@ -74,5 +74,5 @@ Gnuplot must be in the system PATH. You can check availability with `pyramses.__
 
 ## Next Steps
 
-- [API Reference](/pyramses/api-reference/) — Full API documentation
-- [Examples](/pyramses/examples/) — Practical usage examples
+- [API Reference](/stepss-docs/pyramses/api-reference/) — Full API documentation
+- [Examples](/stepss-docs/pyramses/examples/) — Practical usage examples

src/content/docs/pyramses/overview.md

@@ -31,8 +31,8 @@ PyRAMSES supports both Windows and Linux operating systems. Pre-compiled RAMSES
 
 ## Further Reading
 
-- [API Reference](/pyramses/api-reference/) — Detailed documentation for `cfg`, `sim`, and `extractor`
-- [Examples](/pyramses/examples/) — Practical simulation examples and notebooks
+- [API Reference](/stepss-docs/pyramses/api-reference/) — Detailed documentation for `cfg`, `sim`, and `extractor`
+- [Examples](/stepss-docs/pyramses/examples/) — Practical simulation examples and notebooks
 
 ## Repository
 

src/content/docs/user-guide/disturbances.md

@@ -188,3 +188,8 @@ Takes a snapshot and exports the load flow at a specific time:
 ```
 time(s) LFRESV 'name_of_filename'
 ```
+
+## Next Steps
+
+- [Solver Settings](/stepss-docs/user-guide/solver-settings/) — Configure time steps, tolerances, and parallelism
+- [PyRAMSES Examples](/stepss-docs/pyramses/examples/) — See complete simulation workflows in Python

src/content/docs/user-guide/dynamic-models.md

@@ -159,3 +159,9 @@ DCTL SIM_MINMAXVOLT CTRL_Name VMAX(pu) VMIN(pu) DEADTIME(s) Stop_Simulation(T/F)
 ```
 DCTL SIM_MINMAXSPEED CTRL_Name MAX_SPEED(pu) MIN_SPEED(pu) DEADTIME(s) Stop_Simulation(T/F) ;
 ```
+
+## Next Steps
+
+- [Disturbances](/stepss-docs/user-guide/disturbances/) — Define faults, trips, and parameter changes
+- [Solver Settings](/stepss-docs/user-guide/solver-settings/) — Configure the numerical solver
+- [Model Reference](/stepss-docs/models/ieee-exciters/) — Browse available exciter, governor, and injector models

src/content/docs/user-guide/file-formats.md

@@ -80,3 +80,8 @@ A typical organization:
 - One file for simulation control parameters
 
 These files can be listed in any order in the command file.
+
+## Next Steps
+
+- [Network Modeling](/stepss-docs/user-guide/network/) — Define buses, lines, transformers, and shunts
+- [Power Flow (PFC)](/stepss-docs/user-guide/pfc/) — Set up and run power flow computations