Skip to content

docs: repoint the links the repository split broke - #1

Merged
sajonaro merged 1 commit into
mainfrom
fix-split-broken-links
Aug 14, 2026
Merged

docs: repoint the links the repository split broke#1
sajonaro merged 1 commit into
mainfrom
fix-split-broken-links

Conversation

@sajonaro

Copy link
Copy Markdown
Contributor

Four relative links still pointed into the writ repository from inside this one, where ../../.. now lands on whatever directory happens to contain both checkouts — or on nothing at all, for a reader who cloned this repository alone, which is the normal case:

libraries/README.md core/stdlib/stdlib.writ
tests/models/politics.lib.writ
jobshop-possible/README.md docs/diagrams/jobshop-deadlock.svg
jobshop-best/README.md docs/set-as-chain.md

They are absolute GitHub URLs now. That is already what the rest of this repository does for cross-repository references, and it is the only form that works for someone who has these problems and not the engine beside them.

set-as-chain.md is a case of its own: it does not exist anywhere any more, having gone in writ's 417476d, "README: fix what the split and the kernel change made untrue". The argument it carried — where the chain has no answer the move is absent, and the swap that fixes when the right-hand side is read — is kernel-spec §10.3 now, so both the link and the text that names it point there instead of at a file that has not existed for some time.

Four relative links still pointed into the writ repository from inside this
one, where ../../.. now lands on whatever directory happens to contain both
checkouts — or on nothing at all, for a reader who cloned this repository
alone, which is the normal case:

  libraries/README.md          core/stdlib/stdlib.writ
                               tests/models/politics.lib.writ
  jobshop-possible/README.md   docs/diagrams/jobshop-deadlock.svg
  jobshop-best/README.md       docs/set-as-chain.md

They are absolute GitHub URLs now. That is already what the rest of this
repository does for cross-repository references, and it is the only form that
works for someone who has these problems and not the engine beside them.

set-as-chain.md is a case of its own: it does not exist anywhere any more,
having gone in writ's 417476d, "README: fix what the split and the kernel
change made untrue". The argument it carried — where the chain has no answer
the move is absent, and the swap that fixes when the right-hand side is read —
is kernel-spec §10.3 now, so both the link and the text that names it point
there instead of at a file that has not existed for some time.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@sajonaro
sajonaro merged commit 54818ed into main Aug 14, 2026
1 check failed
@github-actions github-actions Bot locked and limited conversation to collaborators Aug 14, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant