elastic / elastic/ai-github-actions

[information-architecture] Workflows nav links to missing documentation pages

Open
#898 0 comments 0 reactions 0 assignees View on GitHub
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

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.