elastic / elastic/beats

[ux-design-patrol] Streaming docs mix preview page with GA applies_to marker

Closed Beginner friendly
#53,162 1 comment 0 reactions 0 assignees View on GitHub
needs_team
Dominant language
Go
Stars
12.7k
Forks
5k
Avg merge
2d 15m
Merged PRs (30d)
385

Description

Recent commits have introduced UI/UX patterns that diverge from established patterns elsewhere in the codebase. The following inconsistency reduces design consistency for users.

## Design Drift Findings

### 1. `filebeat-input-streaming` mixes preview and GA lifecycle markers on the same page

**Commit(s):** [2e9f4a2d61bfca85cffadffcee926beefa125fa8](https://github.com/elastic/beats/commit/2e9f4a2d61bfca85cffadffcee926beefa125fa8)

**New pattern (introduced by commit):**
```text
{applies_to}`stack: ga 9.4+` The CrowdStrike discover endpoint can return multiple feed resources...
```

**Existing pattern (established elsewhere):**
```text
applies_to:
stack: preview
serverless: preview

This functionality is in technical preview and may be changed or removed...
```

**Location of new pattern:** `docs/reference/filebeat/filebeat-input-streaming.md:59`

**Location of existing pattern:**
- `docs/reference/filebeat/filebeat-input-streaming.md:1-7`
- `docs/reference/filebeat/filebeat-input-streaming.md:12-13`

**User impact:** The same page simultaneously presents the input as technical preview and a newly added section as GA (`stack: ga 9.4+`). Users can misread maturity/support status and rollout guidance for the same feature area.

## Suggested Actions

- [ ] Align lifecycle markers in `docs/reference/filebeat/filebeat-input-streaming.md` so CrowdStrike guidance uses the same maturity designation as the page (or move GA-only guidance to a page/section with consistent GA framing).

---
[What is this?](https://ela.st/github-ai-tools) | [From workflow: UX Design Patrol](https://github.com/elastic/beats/actions/runs/34601940434)

Give us feedback! React with 🚀 if perfect, 👍 if helpful, 👎 if not.
> - [x] expires on Sep 18, 2026, 1:13 PM UTC

Contributor guide

Open the contributing guide

Research direction

Start with docs/reference/filebeat/filebeat-input-streaming.md, especially lines 1-13 and 59, and compare the page-level preview marker with the CrowdStrike guidance. Align the lifecycle designation or separate the GA guidance so the page presents consistent maturity information, then review the rendered documentation for matching support messaging.

Written by the indexing model from the issue text.

Assessment

Tech stack
markdown
Domain
documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
1-3 hours
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
82/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.