elastic / elastic/opentelemetry

Docs fix — staleness: shard 1/1 — 2 findings

Open
#613 0 comments 1 reaction 2 assignees Claimed by @theletterf View on GitHub
docs-fix:staleness docs-quality-sweep
Dominant language
Python
Stars
37
Forks
50
Avg merge
23h 31m
Merged PRs (30d)
3

Description

Generated by `gh-aw-docs-staleness-sweep` for `elastic/opentelemetry` on 2026-W25.

Shard 1/1 · 27 pages in slice · 0 recently-changed · 27 total in scope · corpus 27 pages.
Thresholds: stale_content_months=24, stale_image_min_gap_months=6.

## Findings (2)

```yaml
- file: docs/reference/compatibility/collectors.md
line: 86
category: broken-external-link
severity: high
evidence: "https://github.com/elastic/elastic-agent/tree/v/internal/pkg/otel/samples/linux returned 404 (lychee); URL contains unresolved template placeholder `` which is not a docs-builder substitution"
suggested_fix: |
Replace `` with a specific pinned version tag (e.g. the latest EDOT Collector release)
or point to a stable branch/tag instead of a template placeholder.

- file: docs/reference/index.md
line: 17
category: stale-screenshot
severity: low
evidence: "image images/EDOT-SDKs-Collector.png last modified 10 months before the page's last commit; gap exceeds 6-month threshold"
suggested_fix: |
Re-capture the EDOT SDKs and Collector architecture diagram to reflect the current product structure.
```

## 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
- Three external URLs (redhat.com ×2, elasticstack.slack.com) returned HTTP 403; excluded because 403 typically indicates bot/crawler blocking rather than a broken link and the evidence is insufficient to confirm staleness.
- Two `(redacted) internal fragment-anchor failures (k8s.md, kafka.md pointing to `index.md#understanding-the-elastic-observability-backend`) were excluded — internal link integrity is docs-build's responsibility.
- All version mentions in scope (8.16–9.x) are within Elastic's current support window; no EOL version tokens found requiring remediation.

> Generated by [Docs staleness sweep agent](https://github.com/elastic/opentelemetry/actions/runs/27820353702) · 137.2 AIC · ⌖ 12.9 AIC · ⊞ 33.2K · [◷](https://github.com/search?q=repo%3Aelastic%2Fopentelemetry+is%3Aissue+%22gh-aw-workflow-call-id%3A+elastic%2Fopentelemetry%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.