From 34243bbf6f1370d2826b732ac393eba329ab1c59 Mon Sep 17 00:00:00 2001 From: sjat Date: Wed, 24 Jun 2026 16:26:11 +0200 Subject: [PATCH] docs: record hardware naming scheme, refresh stale mf0x hints --- CLAUDE.md | 3 ++- README.md | 2 +- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 8603279..2d9a20c 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -18,12 +18,13 @@ From `notes/todo/2026-04-14-todo.md`: - **Decisions**: Lightweight markdown decision logs - **License**: FLOSS by default - **Filenames**: ASCII lowercase, kebab-case (`like-this.md`), English regardless of content language. Dated docs use an ISO prefix joined with a hyphen: `YYYY-MM-DD-label.md`. Hostnames are the exception — `docs/hardware/*.md` must equal the host's `hostname` (enforced by `scripts/gen_overview.py`). +- **Hardware identifiers**: `` — 2-digit, unique per kind (`srv`, `sw`, `pp`, `pdu`, `ups`, `shf`). Grouping (`cluster:`) lives in frontmatter, not the name. Full scheme: `notes/dev/specs/2026-06-24-hardware-naming-scheme.md`. ## Repository Structure ``` docs/ # everything here is built and shipped to docs.makerfloss.eu - hardware/ # auto-indexed per-host frontmatter (mf00..mf03, makerfloss.eu) + hardware/ # auto-indexed per-host frontmatter (srv01..srv05, makerfloss.eu) services/ # auto-indexed per-service frontmatter (docs, forgejo, …) infrastructure/ # labdesign, VPS/DNS, etc. presentations/ # Marp decks (build-slides.sh) diff --git a/README.md b/README.md index 7a4c2fa..a438988 100644 --- a/README.md +++ b/README.md @@ -10,7 +10,7 @@ Documentation and working notes for **MakerFLOSS**, an Orange Makerspace initiat ``` docs/ # built into the public site (docs.makerfloss.eu) - hardware/ # auto-indexed per-host frontmatter (mf00..mf03, makerfloss.eu) + hardware/ # auto-indexed per-host frontmatter (srv01..srv05, makerfloss.eu) services/ # auto-indexed per-service frontmatter (docs, forgejo, …) infrastructure/ # labdesign, VPS/DNS, etc. presentations/ # Marp decks (also published to slides.makerfloss.eu)