SpecSheriff
rule · _guidelines/spec/3.2 · s-rwqzepmrt77rv35

Three records, each answering a different question

Checkedconfirmed by its owner

A rule is bound to its implementation by three records: a tag carrying the node's sid, on the symbol in the code that implements it; the node's sid declared by the test that verifies it, so that a run of the tests reports it; and, in the node's metadata, the lists of that code and those tests. All three are written by hand, and they must agree.

Why

Each answers a different question. The tag says what a symbol implements. The sid a test declares says whether the rule is verified, so that a run of the tests is itself a report of which rules are covered. The lists say what implements a rule, to a reader who has the rule open.

The links made to it

The decisions taken on it

2026-10-27 · textual
Problem

A test bound to its rule by the opening of its name cannot be written in a language whose names cannot hold a hyphen.

Ruling

The owner: a test declares the sid of what it verifies however its language allows, so that a run of the tests reports it.

The tests bound to it