docs: Updated todo

This commit is contained in:
sjat 2026-04-14 22:11:09 +02:00
parent 25f27f1f20
commit 2755733ca0
2 changed files with 77 additions and 8 deletions

44
CLAUDE.md Normal file
View file

@ -0,0 +1,44 @@
# 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 `docs/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:
```bash
git clone ssh://git@forgejo.makerfloss.eu:7577/<user>/<repo>.git
```

View file

@ -2,11 +2,36 @@
## makerFLOSS Working Norms (v0.1)
Language: English for code, docs, commits
Git: trunk-based, feature branches, simple commit convention
Environments: containerized, reproducible setups
Hardware: all setups documented with README + labeled physically
AI: allowed, but reviewed; no secrets
Decisions: lightweight markdown decision logs
Collaboration: open, low-barrier, no gatekeeping
License: FLOSS by default
We aim to experiment, learn together and have fun. MakerFLOSS is not the same as the Orange Makers IT setup - but we try to help out where we can.
We try to not have too many rules or guidelines, but here are the main ones:
- Political
- We make mistakes - but try to mostly make them in our labs and not on our production setup.
- If you brake something - try to fix it. If you can't, tell and ask for help.
- We only use non-FLOSS if we really have to.
- We foster collaboration by being open and not gatekeep (everybody can get root access).
- Try not to do anything that will make us have to create a boring rule.
- Technical
- Language: English for code and docs. Danish as primary for service UIs, English as secondary.
- Environments: containerized, reproducible setups.
- Hardware: all setups documented + labeled physically.
- Decisions: lightwieght markdown decision logs.
- Licenses for what we build: MIT by default.
## Hardware request (facebook post)
Orange Makerspaces nye initiativ for åbent og frit software (MakerFLOSS), har brug for dit gamle hardware!
Vi kommer til at bruge det til at eksperimentere, og køre forskellige services til Makerspacet, medlemmerne og forskelligt andet. Det kan også sagtens være vi skiller din donation ad og kun bruger noget af det.
Vi er særligt interreserede i serverudstyr, stationære computere, switche og den slags. Lige nu har vi ikke noget, så rigtigt meget har interesse - men hvis det viser sig ikke at være anvendeligt for os, sætter vi det i første omgang på byttebordet og derefter på den Blå Avis. Hvis du er i tvivl, så skriv en mail til makers@makerfloss.eu.
Hvis du vil donere noget, så sæt det på første sal ved skiltet "Doneret til MakerFLOSS".
På forhånd tak til dem der donerer!
## Services
- https://docs.flarum.org