|
| 1 | +<!-- SPDX-License-Identifier: CC-BY-SA-4.0 --> |
| 2 | + |
| 3 | +# REQUIRES INITIALISATION |
| 4 | + |
| 5 | +**This repository is not finished being set up.** 4 substitution token(s) across 2 file(s) still have no value. |
| 6 | + |
| 7 | +## Why this is not already done |
| 8 | + |
| 9 | +This repo was created from `hyperpolymath/rsr-template-repo`. The mint |
| 10 | +(`just repo-init`) fills every token that has a single mechanical answer — |
| 11 | +owner, repo, author, dates, licence, branch — and it has done so here. |
| 12 | + |
| 13 | +The tokens below are the ones it *deliberately cannot* answer. They need a |
| 14 | +decision or a fact that exists only in your head: what this project is for, |
| 15 | +what command builds it, which port the service listens on, whether a PGP key |
| 16 | +is held at all. The template's own token vocabulary says as much — you cannot |
| 17 | +sensibly answer "required invariants" in a thirty-second bootstrap. |
| 18 | + |
| 19 | +They were left **visibly unfilled on purpose**. The alternatives were both |
| 20 | +worse: inventing plausible values would put confident falsehoods into a |
| 21 | +security policy and an architecture document, and silently deleting the |
| 22 | +sections would hide the fact that a decision is owed. A visible gap is |
| 23 | +honest; a fabricated answer is not. |
| 24 | + |
| 25 | +## Do not delete this file until every item below is resolved |
| 26 | + |
| 27 | +This file is the only marker that the work is outstanding. Deleting it early |
| 28 | +does not finish the setup, it just conceals it — and the next person or agent |
| 29 | +to arrive will reasonably assume the repo is complete. |
| 30 | + |
| 31 | +- **If you are a person:** delete this file yourself once the last item is done. |
| 32 | +- **If you are an agent:** resolve what you legitimately can, leave the rest, |
| 33 | + and delete this file only when no token below remains anywhere in the tree. |
| 34 | + Do not delete it to make a gate go green. |
| 35 | + |
| 36 | +Re-running the estate top-up tool will remove this file automatically once |
| 37 | +nothing is outstanding, so the safest way to finish is to fix the tokens and |
| 38 | +let the check confirm it. |
| 39 | + |
| 40 | +## What is needed, and where it goes |
| 41 | + |
| 42 | +### `{{CONDUCT_TEAM}}` |
| 43 | + |
| 44 | +Name of the conduct body. If there is no committee, rewrite the sentence rather than substituting a plural noun into 'a {{CONDUCT_TEAM}} member'. |
| 45 | + |
| 46 | +Appears in: |
| 47 | + |
| 48 | +- `CODE_OF_CONDUCT.md` |
| 49 | + |
| 50 | +### `{{PGP_KEY_URL}}` |
| 51 | + |
| 52 | +Public URL the PGP key can be fetched from. Same caveat as PGP_FINGERPRINT. |
| 53 | + |
| 54 | +Appears in: |
| 55 | + |
| 56 | +- `SECURITY.md` |
| 57 | + |
| 58 | +### `{{RESPONSE_TIME}}` |
| 59 | + |
| 60 | +Initial-response SLA for a security or conduct report. Promise only what a solo maintainer can actually meet. |
| 61 | + |
| 62 | +Appears in: |
| 63 | + |
| 64 | +- `CODE_OF_CONDUCT.md` |
| 65 | + |
| 66 | +### `{{WEBSITE}}` |
| 67 | + |
| 68 | +Project homepage URL, or delete the field if there is none. |
| 69 | + |
| 70 | +Appears in: |
| 71 | + |
| 72 | +- `SECURITY.md` |
| 73 | + |
| 74 | +--- |
| 75 | + |
| 76 | +Generated by the estate top-up pass. Rationale and the governing rulings are |
| 77 | +in `hyperpolymath/standards`; the token vocabulary is |
| 78 | +`.machine_readable/ai/PLACEHOLDERS.adoc` in `rsr-template-repo`. |
0 commit comments