Repository navigation
fix(site): the registry page is printed without internal words - #327
Merged
Merged
Conversation
the-homeless-god
force-pushed
the
a/registry-page-without-internal-words
branch
from
October 7, 2026 21:01
663238e to
1f1b4da
Compare
Task 2325. The jargon guard refused on four reader pages, and the words could not be fixed on the pages themselves: both halves of the registry page are printed by scripts/site/registry-page.fscript, so an edit in the file would be lost at the next printing. The words are fixed in the printer; the pages are then reprinted by a run. What was and what is, measured by the guard itself (bootstrap/flang run-script jargon:check): docs/site/registry.md 10 internal words -> 0 docs/site/registry.ru.md 9 -> 0 docs/site/packages.md 1 -> 0 docs/site/packages.ru.md 1 -> 0 The words and what replaced them: * the Russian word for a ledger, and "ledger" itself, give way to the Russian and English words for a list. The decision ADR-0059 calls the thing a ledger of names, and inside the project that word is shorter and sharper; on a page read by someone who came for the language it requires knowing our kitchen. A list of names says the same and needs no footnote. * "byte for byte" gives way to "unchanged". The guard asks for this one in words, not as a term. The packages pages are written by hand, not printed, so their one word each is fixed in place. No exception was added to docs/jargon.json and no page was moved into the list of surfaces the guard skips. The guard already blanks link targets, so the name of the decision file in the ADR link was never counted -- that is measured, not assumed: the guard lists lines 3, 7, 12, 27, 43, 49, 63 and 74 of registry.md and never line 10, which is the line with the link. Negative control. One internal word was put back into the printer, in the line that counts the records, and the page reprinted: the guard went from 6 faults to 7 and named the planted place -- registry.ru.md, one internal word where none is allowed, line 62. Restored, and the printer and both halves of the page compare equal to the copies taken before the forgery. The guard still refuses on this branch, with 6 faults in six files none of which this branch touches: the roadmap page, three chapters of the course, the guide on how to write flang, and flang_repl.c. Those six are closed by PR 322, which is not in dev yet. On a tree that is PR 322 plus this change the guard answers with exit code 0 and says it looked at 157 surfaces, saw 992 internal words all of them on the debt list of 34 files, and found 0 new ones.
The registry printer now writes the two halves of the registry page without internal words, and the two packages pages were fixed by hand, so each of the four pages has zero internal words. The jargon guard refuses when a file's count falls below its recorded debt, so the four rows are removed from docs/jargon.json. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PNHrA3rG7FTWhB11E7pjDQ
the-homeless-god
force-pushed
the
a/registry-page-without-internal-words
branch
from
October 7, 2026 22:06
1f1b4da to
f072671
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Задача 2325 (её файл пока лежит на незалитом PR #322, см. последний раздел).
Сторож жаргона отказывал на четырёх читательских страницах. Правка нужна была
в печатнике, а не на страницах: обе половины страницы реестра печатает
scripts/site/registry-page.fscript, и правка в самом файле уехала бы приследующей перепечатке.
Что было и что стало — прогоном
jargon:checkdocs/site/registry.mddocs/site/registry.ru.mddocs/site/packages.mddocs/site/packages.ru.mdЧисла «было» сошлись с числами соседа из задачи 2325 знак в знак.
Какие слова и на что заменены
ведомостью имён, и внутри проекта это слово короче и точнее; на странице, куда
приходят за языком, оно требует знания нашей кухни. «Список имён» говорит то
же и сноски не требует. Заменено в восьми местах русской половины и в семи —
английской, все в печатнике.
термином.
packages.ru.mdиpackages.mdпишутся руками, не печатаются, — их по одномуслову поправлены на месте.
Чего делать НЕ пришлось
Ни одного исключения в
docs/jargon.jsonне добавлено, ни одна страница непереведена в список «вне запрета». Сторож сам затирает адреса ссылок
(
«Проза маркдауна»→«Снять цели»от](), поэтому имя файла решения вссылке
[ADR-0059](../adr/0059-the-registry-is-a-ledger-…md)не считалосьникогда. Это замерено, а не принято на веру: сторож перечисляет строки 3, 7,
12, 27, 43, 49, 63, 74 у
registry.mdи ни разу не строку 10 — ту, где ссылка.(Первая редакция этой ветки добавляла два исключения; они оказались лишними и
сняты.)
Отрицательный контроль
Одно внутреннее слово возвращено в печатник (строка итога, «Записей в списке» →
«Записей в ведомости»), страница перепечатана прогоном:
Код диагностики
FLANG_ZHARGON. Подлог снят, печатник и обе половины страницысошлись с копиями, снятыми до подлога, по
cmp— знак в знак.Прочие прогоны
flang check scripts/site/registry-page.fscriptфункций 92, из них с доказанным завершением 92; замечаний нетflang lintтого же файлаmax-line-length 120: 0; max-conditional-depth 2: 0registry:pageНапечатано: записей 7, обе половины страницы; отпечатки сошлись у всех, код 0diffпосле трёх заменsed: расхождений 0, строк 7node docs/site/build.mjs --checkстраниц 833, битых ссылок 0;пар не хватает 0--no-verifyне применялся: заслоны перед коммитом (no-growth,lint-growth,commit-msg) и перед пушем прошли как есть.Чего эта ветка НЕ закрывает, и это важно
jargon:checkна этой ветке всё ещё отказывает — 6 бед в шести файлах, и ниодного из них ветка не трогает:
docs/site/roadmap.ru.md,docs/course/03-totality.md,docs/course/09-eight-targets.md,docs/course/13-where-next.md,docs/guide/how-to-write-flang.ru.md,flang/src/emit/c/flang_repl.c. Эти шесть закрывает PR #322, которого вdevпока нет.Проверено на объединённом дереве (PR #322 + эта правка): сторож отвечает
кодом 0 —
То есть шаг «Check jargon» работы
uncalled-guardsзеленеет ровно тогда, когдавлиты оба запроса; порядок вливания любой.
Задача 2325
Файл
docs/tasks/2325-the-registry-page-is-printed-with-internal-words.mdлежитна ветке PR #322 и в
devещё не вливался. Своей копии я не завожу: двадобавления одного пути дадут конфликт на вливании второго запроса. После
вливания #322 в задаче надо поправить две строки: