sjat f6d589edec

Build docs site / build (push) Successful in 31s

Details

Build slides / build (push) Successful in 49s

Details

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.8 KiB

Raw Blame History

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

This is a documentation-only repository for the MakerFLOSS initiative at Orange Makerspace — a bi-weekly FLOSS jam-session community focused on self-hosted, open-source infrastructure. There is no build system, test suite, or application code.

Working Norms

From notes/todo/2026-04-14_todo.md:

Language: English for code, docs, commits (meeting notes may be in Danish)
Git: Trunk-based development, feature branches, simple commit messages
Environments: Containerized and reproducible
Hardware: All setups documented with README + labeled physically
AI: Allowed but reviewed; no secrets in commits
Decisions: Lightweight markdown decision logs
License: FLOSS by default

Repository Structure

docs/
  infrastruktur/   # Infrastructure documentation (VPS, DNS, etc.)
  kommunikation/   # Communication materials (Facebook posts, announcements)
  møder/           # Meeting notes
  todo/            # Task lists and working norms

Infrastructure

The MakerFLOSS infrastructure is managed externally via the AnsibleBaobabV4 Ansible project (hosted at forgejo.nyumbani.baobab.band/sjat/AnsibleBaobabV4). Key facts:

VPS: 88.99.32.236, SSH on port 7576
Forgejo (self-hosted git forge): https://forgejo.makerfloss.eu, SSH on port 7577
Reverse proxy: Traefik with automatic Let's Encrypt TLS
DNS: makerfloss.eu via Gandi.net, managed declaratively through Ansible (play_dns.yml --limit makerfloss)
DNS records must never be edited directly in the Gandi panel — always edit host_vars/makerfloss.yml in AnsibleBaobabV4

Clone via Forgejo SSH:

git clone ssh://git@forgejo.makerfloss.eu:7577/<user>/<repo>.git