Fix broken cross-references in docs

Update links to match new doc structure:
- index.md: Update documentation table to existing pages
- installation.md: Fix next steps, add inline systemd uninstall
- how-it-works.md: Fix next steps links
- safety.md: Fix next steps links
- faq.md: Fix install.md → installation.md, update next steps
- examples/README.md: Fix see also section

Author: simonmorley

docs/examples/README.md

@@ -115,7 +115,6 @@ When abuse is detected, the report includes specific trigger rules, episode deta
 
 ## See Also
 
-- [Reporting](../reporting.md) — S3 upload and pilot workflow
-- [Deployment Guide](../deployment.md) — Full deployment instructions
-- [Configuration Reference](../configuration.md) — All CLI options
-- [Operations Guide](../operations.md) — Monitoring and maintenance
+- [Reporting](../reporting.md) — Offline reporting workflow
+- [S3 Upload](../s3-upload.md) — Configure snapshot uploads
+- [Installation](../installation.md) — System requirements and setup

docs/faq.md

@@ -314,7 +314,7 @@ IBSR does not enforce anything. It generates evidence about what *would* happen
 
 ## Next Steps
 
-- [Installation](install.md) — Get started
-- [Deployment](deployment.md) — Production deployment with S3 upload
+- [Installation](installation.md) — Get started
+- [S3 Upload](s3-upload.md) — Configure snapshot uploads
 - [Safety Model](safety.md) — Understand guarantees
-- [Reporting](reporting.md) — S3 upload and pilot workflow
+- [Reporting](reporting.md) — Offline reporting workflow

docs/how-it-works.md

@@ -276,5 +276,5 @@ On SIGINT or SIGTERM:
 ## Next Steps
 
 - [Safety Model](safety.md) — Safety guarantees and verification
-- [Configuration](configuration.md) — Tuning options
 - [Reporting](reporting.md) — Offline analysis
+- [FAQ](faq.md) — Common questions

docs/index.md

@@ -130,15 +130,11 @@ The collector runs unattended once configured. There are no dashboards to watch
 
 | Document | Description |
 |----------|-------------|
-| [Installation](install.md) | System requirements and installation methods |
-| [Quick Start](quickstart.md) | Get running in 5 minutes |
-| [Configuration](configuration.md) | CLI reference and tuning options |
-| [Deployment](deployment.md) | Production deployment with systemd |
+| [Installation](installation.md) | System requirements and installation methods |
+| [S3 Upload](s3-upload.md) | Upload snapshots using ibsr-export |
+| [Reporting](reporting.md) | Offline reporting workflow |
 | [How It Works](how-it-works.md) | Technical deep dive |
 | [Safety Model](safety.md) | Safety guarantees and risk profile |
-| [Reporting](reporting.md) | S3 upload and report delivery |
-| [Operations](operations.md) | Monitoring, troubleshooting, maintenance |
-| [Upgrading](upgrading.md) | Version upgrades and rollback |
 | [FAQ](faq.md) | Frequently asked questions |
 
 ## Design Principles

docs/installation.md

@@ -237,10 +237,15 @@ sudo rm -rf /var/lib/ibsr
 
 ### Remove Systemd Service (If Installed)
 
-See [Deployment](deployment.md) for systemd uninstall instructions.
+```bash
+sudo systemctl stop ibsr
+sudo systemctl disable ibsr
+sudo rm /etc/systemd/system/ibsr.service
+sudo systemctl daemon-reload
+```
 
 ## Next Steps
 
-- [Quick Start](quickstart.md) — Get running in 5 minutes
-- [Configuration](configuration.md) — CLI options and tuning
-- [Deployment](deployment.md) — Production deployment with systemd
+- [S3 Upload](s3-upload.md) — Configure snapshot uploads
+- [How It Works](how-it-works.md) — Technical architecture
+- [Safety Model](safety.md) — Safety guarantees

docs/safety.md

@@ -228,5 +228,5 @@ du -sh /var/lib/ibsr/snapshots/
 ## Next Steps
 
 - [How It Works](how-it-works.md) — Technical architecture
-- [Operations](operations.md) — Monitoring and troubleshooting
+- [Reporting](reporting.md) — Offline reporting workflow
 - [FAQ](faq.md) — Common questions