docs(okf): write overview, architecture, decisions and roadmap

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Noel SabiaandClaude Opus 5.5 committed 2026-10-11 14:18:32 +02:00
1 parent 987a5efba1
commit 557ac1985b
20 files changed
+750 -16

No files matched your search

+7
View File
@@ -0,0 +1,7 @@
# Chapters
* [Chapter states](state-mapping.md) - How each Kubernetes primitive and state maps to a meaning in Noel's life story.
# Chapter list
Not written yet. One concept per chapter: dates, state, story, setback, recovery or lesson.
+30
View File
@@ -0,0 +1,30 @@
---
type: Reference
title: Chapter states
description: How each Kubernetes primitive and state maps to a meaning in Noel's life story.
tags: [chapters, k3s, narrative]
status: stable
generated: { by: claude-code/claude-opus-5-5, at: 2026-10-11T12:15:30Z }
---
# Mapping
| Kubernetes | Meaning | Example | Release |
|---|---|---|---|
| Job, Completed | Finished chapter | School, 42 piscine | v1 |
| Deployment, Running and Ready | Active, stable chapter | PreZero, Example | v1 |
| Running, NotReady | Exists, unfinished | Ongoing studies, thesis | v1 |
| CrashLoopBackOff | Failed and stayed failed | Abandoned projects | v1 |
| `restartCount` | Setbacks survived | "fell 3×, stood up 3×" | v1 |
| Replicas, HPA scale-up | Load carried, growth under pressure | Team lead, two businesses | Phase 3 |
| Rolling update | Pivot or reinvention | Career switch | Not planned yet |
Finished chapters are Jobs because they complete. Current chapters are
Deployments because they must stay alive.
# Narrative rules
- Every fall shows a story card: what went wrong and what got Noel back up.
- The recovery time shown is real, measured in seconds.
- Permanently failed chapters show a lesson card, not a recovery.
- Failures are labeled as lessons, never as bugs.