You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@solr.apache.org by "adityamparikh (via GitHub)" <gi...@apache.org> on 2026/07/31 02:37:22 UTC
[PR] docs: fix broken documentation links in README [solr-mcp]
adityamparikh opened a new pull request, #171:
URL: https://github.com/apache/solr-mcp/pull/171
## Summary
Fixes #168 — every documentation link in the README currently 404s.
**Root cause:** the README merged in #151 links into `docs/site/content/pages/mcp/`, a tree that only exists on the unmerged #143 branch. #151 and #143 were developed together, but only the README landed.
**Fix — make the links resolve on main today, without preempting the #143 site-structure discussion:**
- Restore the linked content from the #143 branch into locations that exist on main, adapted for plain GitHub rendering (Pelican frontmatter converted to headings, site-absolute `/mcp/security.html` links repointed at `docs/security/`):
- per-client setup guides (Claude Desktop, Claude Code, VS Code/Copilot, Cursor, JetBrains, MCP Inspector) under `docs/clients/`
- observability guide at `docs/observability.md`
- Repoint the seven broken README links there; the *Quick start* entry now links to the README's own section.
- Fix three more pre-existing broken links found by a repo-wide sweep:
- `docs/security/http.md` + `docs/security/stdio.md` → `../specs/graalvm-native-image.md` (the spec moved to `dev-docs/`)
- `docs/security/keycloak.md` TOC entry for a *User Federation (LDAP/AD)* section that doesn't exist
These files stay wherever the dev@ discussion on #143 lands — a `git mv` at that point, nothing here takes a side on project-site vs product-docs structure.
## Verification
- Repo-wide relative-link check (targets **and** anchors) over all 26 markdown files: all pass.
- `./gradlew build`: BUILD SUCCESSFUL (full test suite).
🤖 Generated with [Claude Code](https://claude.com/claude-code)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@solr.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@solr.apache.org
For additional commands, e-mail: issues-help@solr.apache.org
Re: [PR] docs: fix broken documentation links in README [solr-mcp]
Posted by "epugh (via GitHub)" <gi...@apache.org>.
epugh merged PR #171:
URL: https://github.com/apache/solr-mcp/pull/171
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@solr.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@solr.apache.org
For additional commands, e-mail: issues-help@solr.apache.org