elastic / elastic/docs-content

Docs fix — staleness: shard 20/28 — 7 findings

Open
#6,279 0 comments 0 reactions 0 assignees View on GitHub
docs-fix:staleness docs-quality-sweep
Dominant language
No language data
Stars
47
Forks
261
Avg merge
3d 12h
Merged PRs (30d)
116

Description

Generated by `gh-aw-docs-staleness-sweep` for `elastic/docs-content` on 2026-W19.

Shard 20/28 · 96 pages in slice · 50 recently-changed · 146 total in scope · corpus 2718 pages.
Thresholds: stale_content_months=24, stale_image_min_gap_months=6.

## Findings (7)

```yaml
- file: contribute-docs/syntax-quick-reference.md
line: 606
category: broken-external-link
severity: high
evidence: "https://elastic.github.io/docs-builder/syntax/keyboard returned 404 (lychee)"
suggested_fix: |
update or replace the link to the keyboard markup syntax page, or verify the correct URL on elastic.github.io/docs-builder

- file: contribute-docs/syntax-quick-reference.md
line: 743
category: broken-external-link
severity: high
evidence: "https://elastic.github.io/docs-builder/syntax/mermaid returned 404 (lychee)"
suggested_fix: |
update or replace the link to the Mermaid diagrams syntax page, or verify the correct URL on elastic.github.io/docs-builder

- file: deploy-manage/tools/snapshot-and-restore/azure-repository.md
line: 113
category: broken-external-link
severity: high
evidence: "https://docs.microsoft.com/en-us/rest/api/storageservices/Naming-and-Referencing-Containers%E2%80%94Blobs%E2%80%94and-Metadata returned 404 (lychee)"
suggested_fix: |
replace with the current Microsoft Azure Storage documentation URL for container naming rules, e.g. https://learn.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata

- file: deploy-manage/tools/snapshot-and-restore/google-cloud-storage-repository.md
line: 17
category: broken-external-link
severity: high
evidence: "https://github.com/GoogleCloudPlatform/google-cloud-java/tree/master/google-cloud-clients/google-cloud-storage returned 404 (lychee)"
suggested_fix: |
replace with the current Google Cloud Java Storage client URL, e.g. https://github.com/googleapis/java-storage or https://cloud.google.com/java/docs/reference/google-cloud-storage/latest

- file: contribute-docs/syntax-quick-reference.md
line: 775
category: stale-screenshot
severity: low
evidence: "image images/nav-title.png last modified 6 months before page (image: 2025-11-04, page: 2026-05-04); gap meets 6-month threshold"
suggested_fix: |
re-capture screenshot of the navigation title rendering to reflect the current UI

- file: explore-analyze/visualize/charts/metric-charts.md
line: 26
category: stale-screenshot
severity: low
evidence: "image images/metric-chart.png last modified 6 months before page (image: 2025-11-20, page: 2026-05-05); gap meets 6-month threshold"
suggested_fix: |
re-capture the metric chart screenshot to reflect the current Kibana UI

- file: explore-analyze/visualize/lens.md
line: 119
category: stale-screenshot
severity: low
evidence: "image images/color_mapping.png last modified 10 months before page (image: 2025-07-25, page: 2026-05-05); gap exceeds 6-month threshold"
suggested_fix: |
re-capture the color mapping screenshot to reflect the current Lens UI
```

## Done when
- Stale content has been refreshed, archived, or annotated as historical.
- Stale screenshots are re-captured.
- Broken external links are replaced with current sources.
- Unsupported-version mentions are removed or moved to upgrade docs.
- A PR addressing this issue is merged.

## Notes
- No stale-content pages found in this shard (all 146 in-scope pages are under the 24-month threshold).
- No unsupported-version-mention findings: version references in scope pages are either minimum-version requirements, upgrade-context notes, or release notes (legitimately referencing older versions).
- `bear.png` in `syntax-quick-reference.md` is a placeholder/illustration image (not a UI screenshot) and was excluded from stale-screenshot findings.
- Timeout on `https://azure.microsoft.com/en-gb/documentation/articles/storage-premium-storage excluded (transient failure, not a confirmed 404).
- Private GitHub repo links (`github.com/elastic/autoops`, `github.com/elastic/cloud`) excluded — 404 is expected without authentication.

> Generated by [Docs staleness sweep agent](https://github.com/elastic/docs-content/actions/runs/25373755935/agentic_workflow) · ● 1.3M · [◷](https://github.com/search?q=repo%3Aelastic%2Fdocs-content+is%3Aissue+%22gh-aw-workflow-call-id%3A+elastic%2Fdocs-content%2Fgh-aw-docs-staleness-sweep%22&type=issues)

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.