Skip to content

docs: fix six broken links across docs and frontend README - #2255

Merged
JSv4 merged 1 commit into
Open-Source-Legal:mainfrom
b1rdmania:fix/broken-doc-links
Aug 19, 2026
Merged

docs: fix six broken links across docs and frontend README#2255
JSv4 merged 1 commit into
Open-Source-Legal:mainfrom
b1rdmania:fix/broken-doc-links

Conversation

@b1rdmania

Copy link
Copy Markdown
Contributor

Six broken links, each verified against the tree or with a live HTTP request. Docs only — no code changes.

File Problem Fix
docs/walkthrough/step-8-data-extract.md ../../architecture/llms/README.md — one ../ too many ../architecture/llms/README.md
docs/architecture/agent_corpus_actions_design.md ../llms/README.md resolved to docs/llms/, but llms/ is inside docs/architecture/ llms/README.md
docs/frontend/auth_flow.md ../frontend/src/docs/AUTHENTICATION_PATTERN.md — one ../ too few ../../frontend/src/docs/…
docs/architecture/websocket/frontend.md ChatSourceAtom.ts — the file is .tsx ChatSourceAtom.tsx
frontend/README.md (×2) Create React App docs moved off facebook.github.io/create-react-app (both links 404) create-react-app.dev/docs/…
docs/configuration/frontend-configuration.md Links to blob/main/frontend/public/env-config.js, but that file is gitignored and generated at container start — the link can never resolve Points at frontend/env.sh, the script that generates it

Deliberately left alone

Two clusters of broken links need a maintainer's call, so I didn't guess:

  1. config/graphql/{graphene_types,mutations,queries}.py — referenced from agent_corpus_actions_design.md, commenting_system/*.md, social-media-previews.md, and dual_tree_implementation_plan.md. Those monolithic modules were split into per-domain files (agent_types.py, agent_mutations.py, corpus_queries.py, …), so each reference needs repointing to the right one — an editorial decision, not a mechanical one.
  2. docs/architecture/apollo_cache.md — linked from auth_flow.md:301, but no such file exists anywhere in the repo. Either it was never written or it moved under a different name.

Happy to follow up on either if you tell me where they should point.

Each fix verified against the tree or with a live request:

- step-8-data-extract.md: one ../ too many on the LLM framework link
- agent_corpus_actions_design.md: ../llms/README.md resolved outside
  docs/architecture, where llms/ actually lives
- auth_flow.md: one ../ too few to reach frontend/src/docs/
- websocket/frontend.md: ChatSourceAtom is .tsx, not .ts
- frontend/README.md: Create React App docs moved from
  facebook.github.io/create-react-app to create-react-app.dev (both 404)
- frontend-configuration.md: frontend/public/env-config.js is gitignored
  and generated at container start, so a blob/main link can never
  resolve; point at frontend/env.sh, which generates it
@github-actions

github-actions Bot commented Aug 17, 2026

Copy link
Copy Markdown
Contributor

All contributors have signed the CLA ✍️ ✅
Posted by the CLA Assistant Lite bot.

@b1rdmania

Copy link
Copy Markdown
Contributor Author

recheck

@JSv4 JSv4 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks!

@JSv4
JSv4 merged commit e3d0c37 into Open-Source-Legal:main Aug 19, 2026
5 of 7 checks passed
@github-actions github-actions Bot locked and limited conversation to collaborators Aug 19, 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.

2 participants