From 1544b9d944392c70547157c7c2ea13bec3b16618 Mon Sep 17 00:00:00 2001 From: Matej Gomboc Date: Wed, 29 Jul 2026 21:44:35 +0200 Subject: [PATCH] docs: future-proof the contributor docs for a growing team MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The project anticipates at least one more team member, and three living documents promised "one maintainer" — a sentence that would start lying the day someone joins. SECURITY.md, CONTRIBUTING.md and CLAUDE.md now say "deliberately small team", which stays true on both sides of that day. The constitution's §5 is deliberately untouched. Its wording is role-based ("the maintainer") and still holds; the real amendment — who reviews, who may merge — depends on the member's actual role, and is the maintainer's to write when that person exists rather than guessed at now. Records (changelogs, RFC amendment texts) keep their historical wording: they describe the project as it was, which is their job. Co-Authored-By: Claude Fable 5 --- CHANGELOG.md | 6 ++++++ CLAUDE.md | 2 +- CONTRIBUTING.md | 2 +- SECURITY.md | 4 ++-- 4 files changed, 10 insertions(+), 4 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 2efb04b..2c810cc 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -85,6 +85,12 @@ Release codenames follow the six Noongar seasons — Birak, Bunuru, Djeran, Maku ### Changed +- Contributor documents no longer assume a permanent team of one. `SECURITY.md`, `CONTRIBUTING.md` and + `CLAUDE.md` now say "deliberately small team" — the project anticipates at least one more member, and + a document that promises "one maintainer" would start lying the day they join. The constitution's §5 + is deliberately untouched: its wording is role-based ("the maintainer") and still true, and the real + §5 amendment — who reviews, who may merge — depends on the member's actual role, which is the + maintainer's to write when that person exists. - **The docs repository was merged into this repository, history and all.** The constitution now lives at `CONSTITUTION.md` in the repository root, bound into every session by the repo-root `CLAUDE.md`; RFCs and the documents' changelog live under `docs/`. The import was a true history merge rather than diff --git a/CLAUDE.md b/CLAUDE.md index 5bbbeab..8cd830e 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -20,7 +20,7 @@ Drivers, filesystem, libc and the network stack are all *port* verdicts in the constitution's Borrow Ledger, and they will eventually want their own repos. They start life as members of this Cargo workspace instead, because the HAL and IPC ABI are still moving: splitting them out now would turn every interface -change into a synchronised multi-repo dance for a single maintainer. Promote +change into a synchronised multi-repo dance for a deliberately small team. Promote them out once the ABI stops moving — Phase 2 or 3, not before. Vendored MIT-licensed code (Redox and similar) goes under `vendor/`, one diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 8e60219..9e807eb 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -300,4 +300,4 @@ Update `CHANGELOG.md`'s `[Unreleased]` section for all notable changes, and bump - Design questions belong in [discussions](https://github.com/setonix-os/kernel/discussions) or an RFC - Check existing issues first -- Be patient — this is a one-maintainer project by design +- Be patient — Setonix is a deliberately small team, and every change crosses the maintainer's desk diff --git a/SECURITY.md b/SECURITY.md index f088680..1109fb1 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -15,8 +15,8 @@ Please include: - Steps to reproduce, ideally with a QEMU command line - Which Tier-1 architecture you observed it on, and whether the other is affected -You will get an acknowledgement within a week. This is a one-maintainer project, so please be patient -with the timeline for a fix — but the acknowledgement will not be silent. +You will get an acknowledgement within a week. Setonix is a deliberately small team, so please be +patient with the timeline for a fix — but the acknowledgement will not be silent. ## Supported Versions