Skip to content

Fix Docs Structure & Repair Internal Links - #1750

Closed
winsznx wants to merge 11 commits into
stacks-network:masterfrom
winsznx:master
Closed

winsznx wants to merge 11 commits into
stacks-network:masterfrom
winsznx:master

Conversation

@winsznx

@winsznx winsznx commented Dec 11, 2025 •

Copy link
Copy Markdown

What's changed?

This PR aligns the repository configuration with the actual file structure. Previously, config files like
SUMMARY.md and .gitbook.yaml were pointing to old directories (e.g., concepts/, guides/) that no longer exist.
I've updated them to point to the correct docs/ content (learn, build, operate, reference).

Fixes included:

Repo Structure: Updated SUMMARY.md, CLAUDE.md and workflow files to match the real folder layout.

Redirects: Fixed .gitbook.yaml to ensure old URLs redirect to the new locations.

Broken Links: Scanned and fixed critical 404s in key guides (Mining, Developer Quickstart, Stacking, etc.) where internal links were broken.

Maintenance: Added a check_links.py
script for future link validation.

Result: The documentation site should now build correctly, navigation links will actually work, and the AI bots will know where to look.

@winsznx
winsznx requested a review from a team December 11, 2025 12:17
@CLAassistant

CLAassistant commented Dec 11, 2025 •

Copy link
Copy Markdown

CLA assistant check
All committers have signed the CLA.

@eric-stacks

Copy link
Copy Markdown
Contributor

thank you for this, will review it soon

@winsznx

winsznx commented Dec 22, 2025

Copy link
Copy Markdown
Author

thank you for this, will review it soon

alright Eric

@eric-stacks

Copy link
Copy Markdown
Contributor

@winsznx that root level .gitbook.yaml file was removed and some of these broken links have already been addressed. Thanks for the suggestions though.

@winsznx

winsznx commented Jan 26, 2026

Copy link
Copy Markdown
Author

alright.

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.

3 participants