elastic / elastic/ai-github-actions
[information-architecture] Workflows nav links to missing documentation pages
- Dominant language
- Python
- Stars
- 11
- Forks
- 16
- Avg merge
- 22h 9m
- Merged PRs (30d)
- 31
Description
`mkdocs.yml` includes multiple Workflows navigation entries that point to Markdown files that do not exist under `docs/`, creating dead-end routes and breaking discoverability.
Concrete example:
- `mkdocs.yml:36` maps **Duplicate Issue Detector** to `workflows/gh-agent-workflows/duplicate-issue-detector.md`
- File is missing: `docs/workflows/gh-agent-workflows/duplicate-issue-detector.md`
Additional missing targets are present in the same nav section (`mkdocs.yml:38-80`), resulting in 27 missing nav destinations total.
User impact:
- Users cannot navigate to advertised workflow docs from primary nav.
- Major feature areas appear available but are unreachable, causing confusion and trust loss.
Suggested fix:
- Either add the missing docs pages or remove/hide these entries from nav until pages exist.
- Add CI validation that every `.md` nav target in `mkdocs.yml` exists.
---
[What is this?](https://ela.st/github-ai-tools) | [From workflow: Trigger Information Architecture](https://github.com/elastic/ai-github-actions/actions/runs/24149286224)
Give us feedback! React with 🚀 if perfect, 👍 if helpful, 👎 if not.
Contributor guide
Assessment
This issue has not been assessed yet.