elastic / elastic/ai-github-actions

[information-architecture] Homepage reviewer guide links to missing workflow pages

Open
#905 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

## Information Architecture Findings

### 1. Homepage discovery path leads to dead-end reviewer links
**Area:** Navigation
**Component(s):** `docs/index.md`, `docs/blog/posts/meet-the-reviewers.md`
**Problem:** The homepage routes users to the “Meet the Reviewers” guide, but that guide links to multiple workflow docs that do not exist. Users following this top-level path hit dead ends and cannot continue to setup details from the reviewer overview.
**Suggested improvement:** Replace dead links with existing workflow docs (or add the missing docs pages), then add a docs link-check in CI for blog/workflow cross-links so this path stays navigable.

**Evidence:**
- `docs/index.md:126` links from homepage card to `blog/posts/meet-the-reviewers.md`.
- `docs/blog/posts/meet-the-reviewers.md:25` links to `../../workflows/gh-agent-workflows/pr-review-addresser.md` (missing file).
- `docs/blog/posts/meet-the-reviewers.md:39` links to `../../workflows/gh-agent-workflows/update-pr-body.md` (missing file).
- `docs/blog/posts/meet-the-reviewers.md:45` links to `../../workflows/gh-agent-workflows/estc-docs-pr-review.md` (missing file).

## Suggested Actions
- [ ] Update `meet-the-reviewers.md` to point only to existing reviewer workflow pages, or add the missing pages.
- [ ] Add docs link validation for blog-to-workflow links in CI to prevent future dead-end navigation regressions.

---
[What is this?](https://ela.st/github-ai-tools) | [From workflow: Trigger Information Architecture](https://github.com/elastic/ai-github-actions/actions/runs/24204046174)

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.