Skip to content
IshooThe Ishoo manual

Project memory / Page 45 of 70

This page is one part of The Ishoo manual. The complete manual is a single page, short enough to read in one go: ishoo.app/docs/

Citation checks

Ishoo checks citations of rules and decisions. When an issue, comment or landing note cites a repealed rule or superseded decision, Ishoo names its replacement in one line, without refusing. Looking up a rule or decision also lists every file and issue that cites it.

Rules and decisions change; the text that quotes them doesn't. An issue filed in spring says “per DEC-1”; by autumn DEC-1 is superseded, and an agent reading the issue follows advice nobody holds any more. Citation checks catch that the moment it's written.

What counts as a citation#

  • Rule addresses: an area name, a dot and a number, such as landing.7. Only real area names count, so v1.2 or beta.10 in ordinary text are left alone.
  • Decision numbers: DEC- and a number, however it's padded. DEC-7 and DEC-07 are the same decision.

The nudge#

Filing an issue, editing one, commenting, and landing all check the text they write. A citation of something replaced gets one line in the reply:

text
ISS-01 cites DEC-1, which is superseded; see DEC-02. Cite the current one unless you mean the history.
ISS-01 cites beta.1, which is repealed; see beta.2. Cite the current one unless you mean the history.

It's never a refusal. Sometimes the old record is exactly what's meant, as in “this reverses what DEC-1 chose”. The agent reads the line and decides.

Who cites this?#

ishoo_find with a rule or decision as its id lists everything that cites it: tracked files by path and line, and issues by id. Matching is word-exact, so a search for beta.1 doesn't hit beta.10. Use it before you repeal or supersede something, to see what will need a new citation.

This list is found when asked, with one git grep over the project and a pass over the store. There's no citation index to keep current, so it can't be wrong about a file that changed a minute ago.

Contents