This repository was archived by the owner on Oct 15, 2026. It is now read-only.
Repository navigation
docs: rewrite the tlnet docs in ASD-STE100 - #19
Merged
Merged
Conversation
C37: the org SECURITY.md holds the guarantees and the report route. This copy linked to a disabled form, and only CLAUDE.md linked to it.
C38: it repeated CLAUDE.md and the org CONTRIBUTING, and the copies drifted. The free-tier rule goes with C53.
C33 shape: 05:42 UTC intro, constraints, must knows, verifying a change. Deletes the list-diff and decision-batch hazards, Verification and security, and Repository guardrails (lib holds the engine facts). C21 floor at about 90%, C23 freshness against CTAN's timestamp, C53 no free-tier claim, C69 the scheduler, C75 writing line. Written for the state after the phase 3 refactor PR.
C23 timestamp freshness, C41 diagram with due, C42 no task plan for a fork, C43 pause the healthcheck, C47 re-dispatch commands, C48 zone intro and rows, C53 gross cost, C54 signed files, C63 no private repo, C64 runbook link to lib, C67 mechanics link to lib, C69 terms.
C58: tlnet's own healthcheck badge, valid strong markup, one link to the README's Want your own?, the landing page as the only own step. C23: Is it fresh? reads CTAN's timestamp.
Review Important 1-5: R2 cost wording, no check or upload as a verb or noun, one 23.5-hour reconcile limit, FILTER keeps the subtree and /timestamp. Fact check note: LIST_FLOOR stops a listing that does not have more than 15,000 lines. Canonical change and root-vars lines. Minors: verbs in the ledes, list and accepts, through, vertical lists, revision-number wording, lede split, runbook bullets trimmed to tlnet specifics, elliptical forms, caution order, step 1 tools, subtree for tree, the UUID sentence, quoted link text.
task plan does steps, it does not only show (list, state, diff and split write to .run/). Linter: no copy as a verb, number of bytes for size, no count as a noun, uploads only the changes, schedules a run, the subkey that signs, tlmgr downloads for request. Kept as names: Is it fresh?, mirror rotation, Writing, When a run fails, Want your own?, and the canonical root-vars line (19 words by Rule 8.5).
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 subscribe to this conversation on GitHub.
Already have an account?
Sign in.
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.
Consistency review, phase 5, for tlnet: C21, C23, C33, C37, C38, C41, C42, C43, C47, C48, C53, C54, C58, C63, C64, C67, C69 and C77 (all Markdown and the landing page in ASD-STE100).
task plan(C42, C43), operation (C47), the zone step (C48), gross cost (C53), signed installers (C54), no private repo names (C63), the two terms (C69).Merge after the lib docs PR: links here go to sections that it adds.
Test plan
task check: render matches render.txt<!--UPDATED-->once