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.
152 commits 2 branches 0 tags 1.5 MiB
Find a file
Lars Rossen 834bd406f2
All checks were successful
Build docs site / build (push) Successful in 48s
Details
Build slides / build (push) Successful in 1m6s
Details
slides(tappaas): session details, dev-topology slide, identity login 
Date 24 August; the demo environment is lab1 (zone lab1, lab1.makerfloss.eu
outside / lab1.internal inside). Adds the upstream 'developing TAPPaaS modules'
topology from tappaas.org ahead of our own repo picture, which now carries
forgejo.makerfloss.eu and highlights that this site tracks main, not stable.
Drops the manager-verbs slide; the demo slides carry the verbs where they are
actually used, with network/environment/module status commands.

Cockpit now logs in via identity:identity rather than a local PAM password, and
identity hand-out uses 'authentik-manager user-recovery-link' so no password is
ever read aloud. NOTE: podman.json in Community does not yet declare
identity:identity — the module needs that change before the session.
2026-08-22 18:03:06 +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): session details, dev-topology slide, identity login 2026-08-22 18:03:06 +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.