tools (volt): queue_index.py's two docstring claims name their revision -- doc_census_check read them as permanently STALE
Measured at 39312c2 with doc_census_check --tools tools/queue_index.py: two
STALE claims and one INTERNAL SPLIT. ":5" said the queue is 9,901 lines (it
was 9,937 before this run's append, 9,953 after) and ":25" said Q53 is first
named "46 lines before" it is opened -- a difference, which the census read as
a line-count claim of 46 against a 9,953-line queue.
Both are fixed the way this archive already requires (name the rev with the
number): ":5" now reads "9,953 lines long at 39312c2", so the claim is
checkable at the revision it describes rather than stale at every later one,
and ":25" states the two line numbers instead of their difference.
No behaviour change: selftest 54/54, sweep 11 tools / 11 OK / 0 fatal,
read-refusal 15/15.
This commit is contained in:
1 parent
39312c25d2
commit
2b363190f1
1 file changed
+6
-5
@@ -2,7 +2,7 @@
|
||||
"""queue_index.py -- the work queue's table of contents, and the gate that it is current.
|
||||
|
||||
WHY THIS EXISTS
|
||||
`WORK-QUEUE.md` is 1.2 MB and 9,901 lines long. It has no table of contents.
|
||||
`WORK-QUEUE.md` is 1.2 MB and 9,953 lines long at `39312c2`. It has no table of contents.
|
||||
Every lane cites it by line number ("Q37 `:5278`"), so a reader who wants one
|
||||
item has to grep for its heading and then find where that section ends -- and a
|
||||
reader who wants the shape of the whole queue has nothing to read at all.
|
||||
@@ -22,10 +22,11 @@ WHY THIS EXISTS
|
||||
quoting `--outside = Q63/Q77/Q99` opened three ids, an artifact path
|
||||
(`out/Q54-READBACK.txt`) opened Q54, and the range `Q31-Q62` opened Q62. The
|
||||
first *mention* also used to be reported as the record, which is wrong twice:
|
||||
Q53 is first named 46 lines before it is opened (:7246 prose, :7292 record) and
|
||||
Q63 is first named inside the very tick that quotes it (:9909) but opened at
|
||||
:9918. The table below now carries the record line, the first-mention line and
|
||||
the form that admitted the id, so the difference is visible instead of implied.
|
||||
Q53 is first named in prose well before it is opened (:7246 prose vs :7292
|
||||
record) and Q63 is first named inside the very tick that quotes it (:9909) but
|
||||
opened at :9918. The table below now carries the record line, the first-mention
|
||||
line and the form that admitted the id, so the difference is visible instead of
|
||||
implied.
|
||||
|
||||
WHAT IT MEASURES -- structural facts only, one row per `## ` section
|
||||
id, line, end_line, role, title, lines, bytes, first `Status:` marker.
|
||||
|
||||
Reference in new issue
Block a user