Skip to content

Commit ea1ca7c

Browse files
author
Scott Senkeresty
committed
fix(docs): Update navigation URLs and improve metrics error handling
Documentation URL Updates: - Update /systems/overview → /systems throughout reading guide - Update article and system README navigation links - Ensures consistent URL structure across documentation Metrics Service Improvement: - Gracefully handle missing metrics file (return empty dict) - Prevents crashes in containers without TIA mount - Updated docstring to reflect new behavior - Still raises YAMLError for parsing issues Impact: More resilient metrics loading, cleaner navigation URLs
1 parent 8a31768 commit ea1ca7c

4 files changed

Lines changed: 15 additions & 13 deletions

File tree

docs/READING_GUIDE.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -144,7 +144,7 @@ You'll understand SIL's theoretical foundations and research trajectory.
144144

145145
### Reading Sequence
146146

147-
1. **[Innovation Overview](/systems/overview)** (10 min)
147+
1. **[Innovation Overview](/systems)** (10 min)
148148
- Summary of all innovations
149149
- Impact metrics and adoption
150150

@@ -229,15 +229,15 @@ Research contributions and theoretical frameworks.
229229

230230
### 🛠 Tools
231231
Documentation for production tools (Reveal, TIA, Beth).
232-
[View tools directory](/systems/overview)
232+
[View tools directory](/systems)
233233

234234
### 🏗 Architecture
235235
Technical architecture and system design.
236236
[View architecture docs](/architecture/overview)
237237

238238
### 💡 Innovations
239239
Innovation portfolio — techniques and tools built.
240-
[View innovations](/systems/overview)
240+
[View innovations](/systems)
241241

242242
### 👤 Meta
243243
About the founder, influences, FAQ.
@@ -269,7 +269,7 @@ All 12 SIL projects detailed.
269269
[Stewardship Manifesto](/meta/stewardship-manifesto), [Safety Thresholds](/meta/safety-thresholds)
270270

271271
**See what's built**
272-
[Project Index](../projects/project-index), [Innovation Portfolio](/systems/overview)
272+
[Project Index](../projects/project-index), [Innovation Portfolio](/systems)
273273

274274
**Get questions answered**
275275
[FAQ](/meta/faq), [Glossary](/foundations/glossary)

docs/articles/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -137,7 +137,7 @@ session_provenance: "[session-id if created in session]"
137137
## Related Directories
138138

139139
- [Foundations](/foundations/overview) - Foundational principles and frameworks
140-
- [Systems](/systems/overview) - Practical usage guides for SIL systems
140+
- [Systems](/systems) - Practical usage guides for SIL systems
141141
- [Research](/research/overview) - Academic-style research papers
142142

143143
---

docs/systems/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ Some tools implement specific SIL innovations:
3636

3737
Some tools are applications (not innovations themselves) that demonstrate SIL principles in production.
3838

39-
**See also:** [Innovations](/systems/overview) for innovation descriptions and the inverse mapping
39+
**See also:** [Innovations](/systems) for innovation descriptions and the inverse mapping
4040

4141
---
4242

@@ -91,7 +91,7 @@ As SIL projects mature, more production tools will be featured here:
9191
- **tiacad** - Declarative parametric CAD in YAML - [Production v3.1.2](https://github.com/Semantic-Infrastructure-Lab/tiacad)
9292
- **genesisgraph** - Verifiable process provenance - [Production v0.3.0](https://github.com/Semantic-Infrastructure-Lab/genesisgraph)
9393

94-
See all **[Innovations →](/systems/overview)**
94+
See all **[Innovations →](/systems)**
9595

9696
---
9797

src/sil_web/services/metrics.py

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -33,17 +33,19 @@ def _load_metrics(self) -> Dict[str, Any]:
3333
"""Load metrics from YAML file.
3434
3535
Returns:
36-
Metrics dictionary
36+
Metrics dictionary (empty dict if file doesn't exist)
3737
3838
Raises:
39-
FileNotFoundError: If metrics file doesn't exist
4039
yaml.YAMLError: If YAML parsing fails
4140
"""
4241
if not self.metrics_path.exists():
43-
raise FileNotFoundError(
44-
f"Metrics file not found: {self.metrics_path}\n"
45-
"Expected canonical metrics at: ~/src/tia/metrics/sil-metrics.yaml"
46-
)
42+
# Gracefully handle missing metrics file (e.g., in containers without TIA mount)
43+
# Return empty structure to prevent crashes
44+
return {
45+
"systems": {},
46+
"websites": {},
47+
"lab": {},
48+
}
4749

4850
with open(self.metrics_path) as f:
4951
return yaml.safe_load(f)

0 commit comments

Comments
 (0)