All 8 documentation links in .github/CONTRIBUTING.md point at the repository
root of yiisoft/docs, but those files now live under src/internals/. Every
one of them 404s, including the five under # Prerequisites — the documents a
first-time contributor is told to read before contributing.
Because this file is the template every package is scaffolded from, the same
broken links are already present verbatim in the packages. I checked
yii-runner-http, router, di and db: all four carry 7 of these 8 links and
are byte-identical on the link set.
Reproduction
Open any link under # Prerequisites, e.g.
https://github.com/yiisoft/docs/blob/master/006-git-commit-messages.md → 404.
Verified 2026-08-16, all 8 targets:
| file |
docs/blob/master/ |
docs/blob/master/src/internals/ |
001-yii-values.md |
404 |
200 |
003-roadmap.md |
404 |
200 |
004-namespaces.md |
404 |
200 |
005-development-tool.md |
404 |
200 |
006-git-commit-messages.md |
404 |
200 |
007-exceptions.md |
404 |
200 |
008-interfaces.md |
404 |
200 |
010-code-style.md |
404 |
200 |
The root of yiisoft/docs no longer contains any numbered .md file.
Suggested fix
Repoint the 8 links to https://github.com/yiisoft/docs/blob/master/src/internals/<file>.
Possible prevention
yiisoft/docs already ships a .markdown-link-check.json, but the checker does
not appear to cover the CONTRIBUTING.md files carried by the downstream
packages — which is likely why this went unnoticed. Extending the check to the
template (and/or to the packages) would catch the next relocation.
I am happy to open the PR for the link fix if that is useful — please let me know
whether contributions require a CLA or DCO sign-off, as I could not find either
documented in yiisoft/.github, in the package CONTRIBUTING.md files, or in
src/internals/.
All 8 documentation links in
.github/CONTRIBUTING.mdpoint at the repositoryroot of
yiisoft/docs, but those files now live undersrc/internals/. Everyone of them 404s, including the five under
# Prerequisites— the documents afirst-time contributor is told to read before contributing.
Because this file is the template every package is scaffolded from, the same
broken links are already present verbatim in the packages. I checked
yii-runner-http,router,dianddb: all four carry 7 of these 8 links andare byte-identical on the link set.
Reproduction
Open any link under
# Prerequisites, e.g.https://github.com/yiisoft/docs/blob/master/006-git-commit-messages.md → 404.
Verified 2026-08-16, all 8 targets:
docs/blob/master/docs/blob/master/src/internals/001-yii-values.md003-roadmap.md004-namespaces.md005-development-tool.md006-git-commit-messages.md007-exceptions.md008-interfaces.md010-code-style.mdThe root of
yiisoft/docsno longer contains any numbered.mdfile.Suggested fix
Repoint the 8 links to
https://github.com/yiisoft/docs/blob/master/src/internals/<file>.Possible prevention
yiisoft/docsalready ships a.markdown-link-check.json, but the checker doesnot appear to cover the
CONTRIBUTING.mdfiles carried by the downstreampackages — which is likely why this went unnoticed. Extending the check to the
template (and/or to the packages) would catch the next relocation.
I am happy to open the PR for the link fix if that is useful — please let me know
whether contributions require a CLA or DCO sign-off, as I could not find either
documented in
yiisoft/.github, in the packageCONTRIBUTING.mdfiles, or insrc/internals/.