Skip to content

Fix dead style guide and docs template links in the contributing guides - #1997

Merged
zksquirrel merged 3 commits into
ZecHub:mainfrom
Briefking23:fix/contributing-guide-dead-links
Aug 27, 2026
Merged

Fix dead style guide and docs template links in the contributing guides#1997
zksquirrel merged 3 commits into
ZecHub:mainfrom
Briefking23:fix/contributing-guide-dead-links

Conversation

@Briefking23

@Briefking23 Briefking23 commented Aug 25, 2026

Copy link
Copy Markdown

Summary

Both links in the "Style Guides" and "ZecHub Wiki" sections of the contributing guides return 404. This fixes them in both copies.

The two dead links

Link Location Status
styles/guide.md site/contribute/Contributing_Guide.md:37, CONTRIBUTING.md:30 404 — no styles/ directory exists
blob/main/template.md site/contribute/Contributing_Guide.md:79, CONTRIBUTING.md:51 404 — no template.md exists anywhere in the repo

What changed

  • Style guide link now points at the live style guide page. Contributing_Guide.md already used this URL further down the same file, so this makes the two references consistent. CONTRIBUTING.md uses a repo-relative path to site/contribute/Style_Guide.md, since it renders on GitHub rather than on the wiki.
  • Docs template link is removed rather than repointed. I searched the tree and there is no wiki page template — the only templates present are newsletter/newslettertemplate.md and a Hackathon issue template, neither of which is what the sentence means. Pointing at an approximate substitute would be worse than removing it. If a template does exist somewhere I missed, say so and I'll restore the link.

Also included

  • site/contribute/ZecWeekly_Newsletter.md — the clone command uses YOUR-USERNAME as a placeholder and 404s if pasted verbatim. Added one clarifying line.
  • site/contribute/Style_Guide.md — links a "tweets style guide" at ./tweets.md, which does not exist. Folded the guidance into the existing paragraph. This is a separate commit; happy to drop it if you'd rather keep this PR to the two links.

Not included

18 locales (ak ar de ee es fr hi ig it ja ko pt ru sw tr uk yo zh) carry the same two dead links in their translated copies under translations/. I've left them alone — those are pipeline-generated and translation/detect-staleness.mjs compares against git history, so hand-editing them would fight the tooling. Happy to open a follow-up if you'd prefer them fixed directly.

Verification

Confirmed via git ls-files and a full-tree search that no styles/ directory, template.md, or tweets.md exists in the repository. Destination page loaded in a browser.

Briefking23 added 3 commits August 25, 2026 11:19
The style guide link pointed at styles/guide.md, which does not exist.
The docs template link pointed at template.md, which does not exist
anywhere in the repository. Both returned 404.

Style guide now points at the live page; the template reference is
removed rather than repointed, since there is no template to point to.

Both fixes applied to CONTRIBUTING.md and site/contribute/Contributing_Guide.md,
which carried identical broken links.
The clone URL uses YOUR-USERNAME as a placeholder and 404s if pasted
verbatim, which is what a first-time contributor will do.
Linked ./tweets.md, which does not exist in the repository. Folded the
guidance into the existing paragraph instead.
@zksquirrel
zksquirrel merged commit c6c275f into ZecHub:main Aug 27, 2026
4 of 5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants