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>
22 lines
1,010 B
Markdown
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.
|