Development record
docs/explanation/rationale.md rests its load-bearing audience definition on an external social-media URL. The page defines who a product thinker is by linking a third-party post — a link-rot-prone foundation for the record's most important audience claim. When the page is next edited (the adopted plan expands it with the ownership/movability/build-to-learn rationale), the definition should be restated in the page's own words with the link demoted to a credited source under citation health (itd-101's alive-links scope).
issueresolvednitpickiss-2608261719070527
docs/explanation/rationale.md rests its load-bearing audience definition on an external social-media URL. The page defines who a product thinker is by linking a third-party post — a link-rot-prone foundation for the record's most important audience claim. When the page is next edited (the adopted plan expands it with the ownership/movability/build-to-learn rationale), the definition should be restated in the page's own words with the link demoted to a credited source under citation health (itd-101's alive-links scope).
Frontmatter
| id | iss-2608261719070527 |
|---|---|
| type | issue |
| lifecycle | resolved |
| severity | nitpick |
.abcd/work/issues/resolved/iss-2608261719070527-rationale-audience-definition-rests-on.md
open on GitHub ↗ · commit history ↗
mentions1
- itd-101**Every citation abcd publishes is provably alive and honestly labelled — and the gate that enforces it never flakes.** A cited reference page is only as trustworthy as its links, and links rot silently: pages retitle, URLs redirect, whole platforms announce their own shutdown. abcd splits citation validation across a deterministic gate and an explicit refresh. An offline lint family checks structure and source policy on every commit — footnote markers and definitions in bijection, URLs and DOIs well-formed, aggregator domains refused — with zero network in the gate. `abcd docs cite refresh` does the live fetching on demand and writes a committed baseline: per URL, the final resolved address, when it was last checked, and whether verification was automatic or manual — never how. Sources that block automated fetchers join a manual queue the maintainer clears link by link: printed as a checklist first, later as a generated, disposable checklist page that hands back a receipt file the verb ingests. The lint then enforces the baseline offline — no broken entries, no stale entries, no cited URL without a receipt, no citation whose recorded final address has drifted. The engine is native and dependency-free first; a specialist link checker can slot in later behind the same seam. "My release gate stays deterministic and my citations stay alive," said Kira, an open-source maintainer. "When a source needs human eyes, abcd hands me the exact list to click through and records that I did — not how I did it."