From f6d589edeccdecb8f9d5557501f22254d16c7cda Mon Sep 17 00:00:00 2001 From: sjat Date: Mon, 18 May 2026 16:53:27 +0200 Subject: [PATCH] docs: split published site (docs/) from internal notes (notes/) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The docs/ tree previously conflated published-site content (3 pages were in mkdocs.yml nav) with working notes (~18 files that just sat in the repo). Restructure so each tree means one thing: - docs/ everything here is built and shipped to docs.makerfloss.eu. Adds docs/presentations/ for the two Marp decks previously living under docs/møder/. - notes/ repo-only working material, not built. Contains meetings/, todo/, dev/ (was docs/superpowers/), and communications/ (the launch Facebook post). - sandbox/ test-mermaid.md, the Marp/Mermaid pipeline sandbox. Other touches: - Drop "_noter" suffix on meeting filenames; drop "_presentation" from the messaging deck's basename for symmetry with SoMe-taxonomi. - Update CLAUDE.md and docs/index.md path references. - Drop the now-redundant --exclude-dir=superpowers from build-slides.sh since superpowers/ is no longer under docs/. Co-Authored-By: Claude Opus 4.7 (1M context) --- CLAUDE.md | 2 +- build-slides.sh | 2 +- docs/index.md | 2 +- docs/{møder => presentations}/2026-05-11_SoMe-taxonomi.md | 0 .../2026-05-11_messaging.md} | 0 .../communications}/2026-03-16_facebookpost.md | 0 .../dev}/plans/2026-05-10-mermaid-pipeline.md | 0 .../dev}/specs/2026-05-10-mermaid-pipeline-design.md | 0 docs/møder/2026-03-16_noter.md => notes/meetings/2026-03-16.md | 0 {docs/møder => notes/meetings}/2026-05-11.md | 0 {docs => notes}/todo/2026-04-14_todo.md | 0 {docs => notes}/todo/OM_services.md | 0 {docs => notes}/todo/indkøbsliste.md | 0 {docs => sandbox}/test-mermaid.md | 0 14 files changed, 3 insertions(+), 3 deletions(-) rename docs/{møder => presentations}/2026-05-11_SoMe-taxonomi.md (100%) rename docs/{møder/2026-05-11_messaging-presentation.md => presentations/2026-05-11_messaging.md} (100%) rename {docs/kommunikation => notes/communications}/2026-03-16_facebookpost.md (100%) rename {docs/superpowers => notes/dev}/plans/2026-05-10-mermaid-pipeline.md (100%) rename {docs/superpowers => notes/dev}/specs/2026-05-10-mermaid-pipeline-design.md (100%) rename docs/møder/2026-03-16_noter.md => notes/meetings/2026-03-16.md (100%) rename {docs/møder => notes/meetings}/2026-05-11.md (100%) rename {docs => notes}/todo/2026-04-14_todo.md (100%) rename {docs => notes}/todo/OM_services.md (100%) rename {docs => notes}/todo/indkøbsliste.md (100%) rename {docs => sandbox}/test-mermaid.md (100%) diff --git a/CLAUDE.md b/CLAUDE.md index 56b3a58..2ff6031 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -8,7 +8,7 @@ This is a **documentation-only repository** for the MakerFLOSS initiative at Ora ## Working Norms -From `docs/todo/2026-04-14_todo.md`: +From `notes/todo/2026-04-14_todo.md`: - **Language**: English for code, docs, commits (meeting notes may be in Danish) - **Git**: Trunk-based development, feature branches, simple commit messages diff --git a/build-slides.sh b/build-slides.sh index d0653de..e5c74da 100755 --- a/build-slides.sh +++ b/build-slides.sh @@ -15,7 +15,7 @@ find "$OUTPUT_DIR" -maxdepth 1 -name "*.html" -delete SLIDES=() while IFS= read -r f; do SLIDES+=("$f") -done < <(grep -rl "^marp: true" "$REPO_ROOT/docs" --include="*.md" --exclude-dir=superpowers 2>/dev/null || true) +done < <(grep -rl "^marp: true" "$REPO_ROOT/docs" --include="*.md" 2>/dev/null || true) if [ ${#SLIDES[@]} -eq 0 ]; then echo "No marp presentations found in docs/." diff --git a/docs/index.md b/docs/index.md index ef68159..9a99788 100644 --- a/docs/index.md +++ b/docs/index.md @@ -18,5 +18,5 @@ jam-session community focused on self-hosted, open-source infrastructure. - **Environments:** containerised and reproducible. - **Hardware:** all setups documented (this site) and physically labelled. - **Decisions:** lightweight markdown decision logs under - [`docs/superpowers/`](https://forgejo.makerfloss.eu/sjat/MakerFLOSS/src/branch/main/docs/superpowers). + [`notes/dev/`](https://forgejo.makerfloss.eu/sjat/MakerFLOSS/src/branch/main/notes/dev). - **License:** FLOSS by default; MIT for what we build. diff --git a/docs/møder/2026-05-11_SoMe-taxonomi.md b/docs/presentations/2026-05-11_SoMe-taxonomi.md similarity index 100% rename from docs/møder/2026-05-11_SoMe-taxonomi.md rename to docs/presentations/2026-05-11_SoMe-taxonomi.md diff --git a/docs/møder/2026-05-11_messaging-presentation.md b/docs/presentations/2026-05-11_messaging.md similarity index 100% rename from docs/møder/2026-05-11_messaging-presentation.md rename to docs/presentations/2026-05-11_messaging.md diff --git a/docs/kommunikation/2026-03-16_facebookpost.md b/notes/communications/2026-03-16_facebookpost.md similarity index 100% rename from docs/kommunikation/2026-03-16_facebookpost.md rename to notes/communications/2026-03-16_facebookpost.md diff --git a/docs/superpowers/plans/2026-05-10-mermaid-pipeline.md b/notes/dev/plans/2026-05-10-mermaid-pipeline.md similarity index 100% rename from docs/superpowers/plans/2026-05-10-mermaid-pipeline.md rename to notes/dev/plans/2026-05-10-mermaid-pipeline.md diff --git a/docs/superpowers/specs/2026-05-10-mermaid-pipeline-design.md b/notes/dev/specs/2026-05-10-mermaid-pipeline-design.md similarity index 100% rename from docs/superpowers/specs/2026-05-10-mermaid-pipeline-design.md rename to notes/dev/specs/2026-05-10-mermaid-pipeline-design.md diff --git a/docs/møder/2026-03-16_noter.md b/notes/meetings/2026-03-16.md similarity index 100% rename from docs/møder/2026-03-16_noter.md rename to notes/meetings/2026-03-16.md diff --git a/docs/møder/2026-05-11.md b/notes/meetings/2026-05-11.md similarity index 100% rename from docs/møder/2026-05-11.md rename to notes/meetings/2026-05-11.md diff --git a/docs/todo/2026-04-14_todo.md b/notes/todo/2026-04-14_todo.md similarity index 100% rename from docs/todo/2026-04-14_todo.md rename to notes/todo/2026-04-14_todo.md diff --git a/docs/todo/OM_services.md b/notes/todo/OM_services.md similarity index 100% rename from docs/todo/OM_services.md rename to notes/todo/OM_services.md diff --git a/docs/todo/indkøbsliste.md b/notes/todo/indkøbsliste.md similarity index 100% rename from docs/todo/indkøbsliste.md rename to notes/todo/indkøbsliste.md diff --git a/docs/test-mermaid.md b/sandbox/test-mermaid.md similarity index 100% rename from docs/test-mermaid.md rename to sandbox/test-mermaid.md