sjat/MakerFLOSS
1
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Første midlertidige repo til Orange Makerspaces MakerFLOSS initiativ.
157 commits 2 branches 0 tags 1.5 MiB
Find a file
Lars Rossen 2722c89dcb
All checks were successful
Build docs site / build (push) Successful in 52s
Details
Build slides / build (push) Successful in 1m14s
Details
slides(tappaas): correct the demo commands against a real run 
Installed portainer into lab1 on the live system; several slide commands were
wrong. The verb is 'network-manager add', not 'network-manager zone add', and
there is no 'srv' zone here — the live service zone is 'makerfloss'. Status
verbs need the effective name 'portainer-lab1', while 'module add' takes the
base name. The published host is portainer-lab1.lab1.makerfloss.eu, not
portainer.lab1.makerfloss.eu. Adds the repository registration to Demo 2, which
the deck had never shown.
2026-08-24 21:03:01 +02:00
.forgejo/workflows ci(rack): generate rack artifacts, run tests, add nav entry 2026-06-24 14:00:48 +02:00
docs slides: frame a 'How to implement a TAPPaaS module' deck 2026-08-22 16:01:50 +02:00
notes docs: publish hardware naming scheme and link it from the editing guide 2026-06-29 21:40:09 +02:00
sandbox docs: add proper README at repo root and per-tree READMEs 2026-05-18 17:13:50 +02:00
scripts feat(rack): draw shelf-mounted tower heights in the elevation 2026-06-30 22:11:19 +02:00
slides slides(tappaas): correct the demo commands against a real run 2026-08-24 21:03:01 +02:00
tests feat(rack): draw shelf-mounted tower heights in the elevation 2026-06-30 22:11:19 +02:00
.gitignore slides: frame a 'How to implement a TAPPaaS module' deck 2026-08-22 16:01:50 +02:00
build-slides.sh slides: frame a 'How to implement a TAPPaaS module' deck 2026-08-22 16:01:50 +02:00
CLAUDE.md slides: frame a 'How to implement a TAPPaaS module' deck 2026-08-22 16:01:50 +02:00
LICENSE Initial commit 2026-03-17 10:39:20 +01:00
Makefile docs(hardware): reconcile rack01 to as-mounted layout and document cabling 2026-06-30 21:31:48 +02:00
mkdocs.yml docs(ideas): add Project ideas page with status and owner columns 2026-07-18 16:02:23 +02:00
README.md docs: record hardware naming scheme, refresh stale mf0x hints 2026-06-24 16:26:11 +02:00
requirements-dev.txt feat(rack): gen_rack placement parsing and validation 2026-06-24 13:42:21 +02:00
requirements.txt feat(docs): MkDocs Material site + auto-generated hardware overview 2026-05-17 21:10:58 +02:00

README.md

MakerFLOSS

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

Repository layout

docs/             # built into the public site (docs.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)
notes/            # repo-only working material — not part of the site
  meetings/       # meeting notes (Danish allowed)
  todo/           # task lists, working norms, wishlist, services
  dev/            # internal plans/ and specs/
  communications/ # community comms artefacts
sandbox/          # scratch / pipeline fixtures
scripts/          # build helpers (hardware index, mkdocs hook)

Building locally

Requires Python 3.10+ and, for slide builds, either marp on $PATH or Docker.

python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt

Common targets:

make docs-serve   # live-reload preview at http://127.0.0.1:8000
make docs-build   # strict build into ./site
make docs-index   # regenerate docs/hardware/index.md from per-host frontmatter
make docs-check   # CI drift-check for the hardware index
make slides       # build Marp decks (docs/presentations/*.md) into ./slides

CI runs on the self-hosted Forgejo Actions runner (.forgejo/workflows/docs.yml) and rsyncs the built site to the VPS.

Conventions

  • Filenames: ASCII lowercase, kebab-case (like-this.md). Dated docs use YYYY-MM-DD-label.md. Hardware host pages are the exception — their filename stem must equal the hostname field, enforced by scripts/gen_overview.py.
  • Languages: English for code and docs; Danish allowed in meeting notes and community communications.
  • Git: Trunk-based, feature branches, simple commit messages, no secrets in commits.

See CLAUDE.md for the full working norms and AI-collaboration guidance.

License

MIT — see LICENSE.