Skip to content

Commit ec1fca8

Browse files
docs: add GOVERNANCE and MAINTAINERS (from gist templates) (#34)
## Summary Adds `GOVERNANCE.adoc` and `MAINTAINERS.adoc`, freshly authored from the owner's personal governance/maintainers **gist templates** (benevolent-maintainer model), rendered as AsciiDoc to match repo conventions. This **supersedes the stale equivalents in #33**, which was cut from an old base and could not be lifted safely (see #33 closure note). ## Changes - `GOVERNANCE.adoc` — benevolent-maintainer governance model (founder: Jonathan D.A. Jewell / `@hyperpolymath`) - `MAINTAINERS.adoc` — ownership table + review expectations, references existing `.github/CODEOWNERS` ## Notes - Header matches existing root `.adoc` precedent on `main` (single `MPL-2.0` SPDX line) plus the owner-attribution line required by the repo pre-commit hook. - No licence-policy changes; no files modified — purely additive. - Commit signed (ssh `id_ed25519_signing`). 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 8a70876 commit ec1fca8

2 files changed

Lines changed: 141 additions & 0 deletions

File tree

GOVERNANCE.adoc

Lines changed: 93 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,93 @@
1+
// SPDX-License-Identifier: MPL-2.0
2+
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
3+
= Governance
4+
5+
[NOTE]
6+
====
7+
Personal / solo-project model (Benevolent Maintainer). Last reviewed: 2026-06-22.
8+
====
9+
10+
== Project status
11+
12+
This project is governed by a *Benevolent Maintainer* model.
13+
14+
The project founder retains final authority over project direction,
15+
architecture, releases, licensing, and governance.
16+
17+
== Founder
18+
19+
Current founder and lead maintainer:
20+
21+
* Jonathan D.A. Jewell (`@hyperpolymath`)
22+
23+
== Decision making
24+
25+
Normal decisions are made by the founder.
26+
27+
Contributors are encouraged to:
28+
29+
* open issues
30+
* submit pull requests
31+
* propose designs
32+
* discuss alternatives
33+
34+
Feedback is considered in good faith but does not bind the project.
35+
36+
== Contributions
37+
38+
Contributions are welcome. See `CONTRIBUTING.md` for how to get started.
39+
40+
Submitting a contribution does not guarantee acceptance. The founder may:
41+
42+
* accept a contribution
43+
* request changes
44+
* reject a contribution
45+
* replace a contribution with an alternative implementation
46+
47+
without further justification.
48+
49+
== Architectural direction
50+
51+
The founder is responsible for:
52+
53+
* project vision
54+
* long-term roadmap
55+
* architecture
56+
* naming
57+
* release strategy
58+
59+
== Maintainers
60+
61+
Additional maintainers may be appointed by the founder (see `MAINTAINERS.adoc`).
62+
Maintainers may review changes, merge pull requests, and manage issues unless
63+
otherwise restricted. The founder may remove maintainers at any time.
64+
65+
== Code of conduct
66+
67+
All participants are expected to follow the project's `CODE_OF_CONDUCT.md`.
68+
The founder is the point of contact for enforcement.
69+
70+
== Security
71+
72+
Report suspected vulnerabilities *privately* as described in `SECURITY.md`.
73+
Please do not disclose vulnerabilities in public issues.
74+
75+
== Forking
76+
77+
Users are free to fork the project according to the license. Forks are
78+
independent projects and are not considered official unless explicitly
79+
designated.
80+
81+
== Governance changes
82+
83+
This document may be amended by the founder.
84+
85+
== Project continuity
86+
87+
If the founder permanently ceases maintenance:
88+
89+
. a successor may be appointed;
90+
. ownership may be transferred;
91+
. the project may become community-maintained.
92+
93+
Until such designation exists, no successor is implied.

MAINTAINERS.adoc

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
// SPDX-License-Identifier: MPL-2.0
2+
// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
3+
= Maintainers
4+
5+
This project is maintained by:
6+
7+
* `@hyperpolymath`
8+
9+
== Ownership
10+
11+
[cols="1,1",options="header"]
12+
|===
13+
| Area | Maintainer
14+
15+
| All files | `@hyperpolymath`
16+
| `README*` | `@hyperpolymath`
17+
| `LICENSE` | `@hyperpolymath`
18+
| `SECURITY*` | `@hyperpolymath`
19+
| `CONTRIBUTING*` | `@hyperpolymath`
20+
| `docs/` | `@hyperpolymath`
21+
| `*.md` / `*.mdx` / `*.adoc` | `@hyperpolymath`
22+
|===
23+
24+
Review routing is enforced via `CODEOWNERS` so GitHub requests reviews
25+
automatically.
26+
27+
== Review expectations
28+
29+
* Paired with `CODEOWNERS` so GitHub requests reviews automatically.
30+
* Target first-response time for issues and pull requests: *best effort*.
31+
32+
== Becoming a maintainer
33+
34+
Additional maintainers may be invited by the founder after a track record of
35+
helpful, high-quality contributions. There is no obligation to accept
36+
contributions or to add maintainers.
37+
38+
== Security contact
39+
40+
Report suspected vulnerabilities *privately* — see `SECURITY.md`, or contact
41+
`@hyperpolymath` directly. Please avoid opening public issues for suspected
42+
vulnerabilities unless explicitly requested.
43+
44+
== Related files
45+
46+
* `GOVERNANCE.adoc` — decision-making model.
47+
* `CODEOWNERS` — review routing for repositories.
48+
* `SECURITY.md` — vulnerability disclosure policy.

0 commit comments

Comments
 (0)