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

22 lines
1,010 B
Markdown

# MakerFLOSS Docs
Documentation for the [MakerFLOSS](https://forgejo.makerfloss.eu/sjat/MakerFLOSS)
initiative at [Orange Makerspace](https://orangemakers.dk) — a bi-weekly FLOSS
jam-session community focused on self-hosted, open-source infrastructure.
## Sections
- [Hardware](hardware/index.md) — every machine in the lab, auto-indexed from per-host
frontmatter blocks. Use this when planning where to deploy a new service.
- [House rules](makerFLOSS_house_rules.md) — 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/`](https://forgejo.makerfloss.eu/sjat/MakerFLOSS/src/branch/main/notes/dev).
- **License:** FLOSS by default; MIT for what we build.