MakerFLOSS/docs/index.md
sjat f6d589edec
All checks were successful
Build docs site / build (push) Successful in 31s
Build slides / build (push) Successful in 49s
docs: split published site (docs/) from internal notes (notes/)
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) <noreply@anthropic.com>
2026-05-18 16:53:27 +02:00

1,010 B

MakerFLOSS Docs

Documentation for the MakerFLOSS initiative at Orange Makerspace — a bi-weekly FLOSS jam-session community focused on self-hosted, open-source infrastructure.

Sections

  • Hardware — every machine in the lab, auto-indexed from per-host frontmatter blocks. Use this when planning where to deploy a new service.
  • House rules — working norms, governance, and what we do (and don't) do.

Working norms (summary)

  • Language: English for code and docs. Danish allowed in meeting notes and community communications.
  • Environments: containerised and reproducible.
  • Hardware: all setups documented (this site) and physically labelled.
  • Decisions: lightweight markdown decision logs under notes/dev/.
  • License: FLOSS by default; MIT for what we build.