diff --git a/docs/makerFLOSS_house_rules.md b/docs/makerFLOSS_house_rules.md index 209584a..ad2996c 100644 --- a/docs/makerFLOSS_house_rules.md +++ b/docs/makerFLOSS_house_rules.md @@ -5,22 +5,22 @@ pagination: true # makerFLOSS – Working Norms (v0.1) -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 aim to experiment, learn together, and have fun. MakerFLOSS is not the same as the Orange Makerspace IT setup — but we help out where we can. -We try to not have too many rules or guidelines, but here are the main ones: +We keep rules to a minimum. 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. + - We make mistakes — but try to make them in our labs, not in production. + - If you break something, try to fix it. If you can't, say so and ask for help. + - We only use proprietary software when there is no FLOSS alternative. + - We foster collaboration by being open and not gatekeeping (everyone can get root access). + - Try not to do anything that forces us to write a new rule. - Technical - - Language: English for code, docs, commits (meeting notes may be in Danish) + - Language: English for code, docs, and commits (meeting notes may be in Danish) - Git: Trunk-based development, feature branches, simple commit messages - - Environments: containerized, reproducible setups. - - Hardware: all setups documented + labeled physically. - - AI: Allowed but reviewed; no secrets in commits - - Decisions: lightweight markdown decision logs. - - Licenses for what we build: FLOSS by default. + - Environments: Containerised and reproducible + - Hardware: All setups documented and labeled physically + - AI: Allowed but reviewed — no secrets in commits + - Decisions: Lightweight markdown decision logs + - Licenses: FLOSS by default