Skip to content

Governance

The record is open for input and curated for output. Anyone can propose, challenge, or discuss. A small editor group decides what is merged.

Roles

  • Contributors: anyone. Contributions come in through issues, discussions, and pull requests. No affiliation is required.
  • Editors: a small group drawn from the contributing task forces. Editors review contributions, maintain editorial standards, and merge changes. The current editors are listed in the repository's README.
  • Endorsing organisations: organisations that formally back specific practices after their own review. Endorsements are recorded in the practice's metadata.

How changes happen

  1. A change is proposed: through an issue template, a discussion, or directly as a pull request.
  2. Editors review. Discussion happens in the open, on the issue or pull request.
  3. Any change that alters a practice's status or adds an endorsement requires review by a second editor before merge.
  4. Merged changes appear on the live site immediately and are summarised in the next monthly release.

Practice lifecycle

Practices move through three statuses: draft (proposed, under discussion), reviewed (accepted by the editor group), endorsed (formally backed by at least one named organisation). A practice can also be retired; retired practices remain in the git history and in dated releases.

Disagreement

Disagreement is valuable content. If organisations or contributors hold different positions on a practice, the practice page records the positions and who holds them, rather than forcing a false consensus. The "Challenge a practice" issue template exists for exactly this.