From 48a72de10e429616fd6d61205286ac11336abc16 Mon Sep 17 00:00:00 2001 From: sjat Date: Sun, 10 May 2026 19:14:23 +0200 Subject: [PATCH] docs: clarify language and fix grammar in house rules MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Fix brake → break - Fix gatekeep → gatekeeping, everybody → everyone - Cleaner prose throughout, consistent punctuation in lists - non-FLOSS → proprietary software (more universally understood) - Shorten "Licenses for what we build" → "Licenses" Co-Authored-By: Claude Sonnet 4.6 --- docs/makerFLOSS_house_rules.md | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) 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