Fix documentation links and income binning

- Add user-guide.md to docs and navigation
- Update all HOW_TO_SUMMARIZE.md references to user-guide.md
- Fix income summary to use income_bin instead of raw values
- Rename 'Validation System' to 'Summary System' in nav

Author: Ennazus

mkdocs.yml

@@ -33,23 +33,16 @@ nav:
   - Getting Started:
     - Installation: install.md
     - Quick Start: index.md#quick-start
-  - Validation System:
-    - Complete Guide: validation-system.md
+    - User Guide: user-guide.md
+  - Summary System:
     - Generate Summaries: generate-summaries.md
+    - Summary Reference: summaries.md
     - CTRAMP Data Model: data-model.md
     - Custom Summaries: custom-summaries.md
-    - External Data Integration: external-data.md
-    - Deploy Dashboard: deploy-dashboard.md
-    - Configuration Reference: configuration.md
-    - Dashboard: dashboard.md
-    - Summaries: summaries.md
+    - External Data: external-data.md
+    - Configuration: configuration.md
   - Development:
-    - Code Flow & Execution: code-flow.md
-    - Development Tasks: validation-development.md
     - Contributing Guide: contributing.md
-  - Reference:
-    - Consolidation Proposal: ../summary/CONSOLIDATION_PROPOSAL.md
-    - Deployment Guide: ../summary/DASHBOARD_DEPLOYMENT.md
 
 markdown_extensions:
   - admonition

tm2py_utils/docs/configuration.md

@@ -456,7 +456,7 @@ binning_specs:
 
 ## See Also
 
-- [HOW_TO_SUMMARIZE.md](../summary/validation/HOW_TO_SUMMARIZE.md) - Complete user guide with examples
+- [HOW_TO_SUMMARIZE.md](user-guide.md) - Complete user guide with examples
 - [README.md](../summary/validation/README.md) - Toolkit overview
 - [summaries.md](summaries.md) - Summary system documentation
 - [generate-summaries.md](generate-summaries.md) - Detailed generation guide

tm2py_utils/docs/generate-summaries.md

@@ -359,7 +359,7 @@ python summarize_model_run.py "path/to/ctramp_output"
 
 The new summary `trip_mode_by_income.csv` will be generated automatically.
 
-See [HOW_TO_SUMMARIZE.md](../summary/validation/HOW_TO_SUMMARIZE.md) for detailed examples.
+See [User Guide](user-guide.md) for detailed examples.
 
 ---
 
@@ -523,7 +523,7 @@ The tool uses ASCII-safe symbols and should work on all Windows terminals. If yo
 - **Validate data quality:** Review validation warnings and investigate issues
 
 See also:
-- [HOW_TO_SUMMARIZE.md](../summary/validation/HOW_TO_SUMMARIZE.md) - Detailed user guide
+- [User Guide](user-guide.md) - Detailed user guide
 - [README.md](../summary/validation/README.md) - Toolkit overview
 - [PREPROCESSING_NOTES.md](../summary/validation/PREPROCESSING_NOTES.md) - Advanced summaries requiring preprocessing
 

tm2py_utils/docs/index.md

@@ -42,7 +42,7 @@ python summarize_model_run.py "C:/path/to/ctramp_output"
 ```
 
 **📚 New to the validation system?** Check out:
-- **[HOW_TO_SUMMARIZE.md](../summary/validation/HOW_TO_SUMMARIZE.md)** - Complete user guide
+- **[User Guide](user-guide.md)** - Complete user guide
 - **[README.md](../summary/validation/README.md)** - Toolkit overview  
 - **[Summaries Guide](summaries.md)** - System documentation
 
@@ -82,7 +82,7 @@ Analysis tools for synthetic population outputs:
 ## Documentation
 
 - [Installation Guide](install.md)
-- [Summaries User Guide](../summary/validation/HOW_TO_SUMMARIZE.md) - **Start here for generating summaries**
+- [Summaries User Guide](user-guide.md) - **Start here for generating summaries**
 - [Summary System Documentation](summaries.md)
 - [Toolkit README](../summary/validation/README.md)
 - [Contributing](contributing.md)

tm2py_utils/docs/summaries.md

@@ -299,6 +299,6 @@ To analyze multiple model runs:
 
 ## Next Steps
 
-- See [HOW_TO_SUMMARIZE.md](../summary/validation/HOW_TO_SUMMARIZE.md) for detailed user guide
+- See [HOW_TO_SUMMARIZE.md](user-guide.md) for detailed user guide
 - Check [README.md](../summary/validation/README.md) for toolkit overview
 - Review [data_model/ctramp_data_model.yaml](../summary/validation/data_model/ctramp_data_model.yaml) for all summary definitions