docs(data-stream): rework the Data Stream section and split its reference into settings, data sources, templates, and endpoints - #2411
Merged
marcus-souza-azion merged 4 commits intoOct 3, 2026
Conversation
marcus-souza-azion
requested review from
a team,
bruno-andrade-azion,
isaque-bock-azion and
pedro-ribeiro-azion
as code owners
October 2, 2026 23:46
Rewrite the Overview and Quickstart, add How it works, Stream settings, Data sources and variables, Templates and payload, Endpoints, Limits, Best practices, Troubleshooting, and Glossary, and rewrite every guide the Data Stream hub lists. Add guides for Apache Kafka and IBM QRadar, and bring the WAF to SIEM guide into the hub. Facts come from the existing pages, the API v4 spec, the Console bundle, and a live API run: a stream carries exactly one of sampling or a workload filter, saving a sampled stream deactivates the others, and an Object Storage credential needs the bucket-list capabilities.
Translate every page and guide of the reworked Data Stream section into Portuguese, with namespaces identical to the English pages. New pages mirror the English file paths so slug checks stay flat.
…target links Register the new Data Stream pages in the sidebar, move SIEM Azion to the Real-Time Metrics reference group, and update the guides hub: kinds set, Kafka, QRadar, and WAF to SIEM added, debug rules tagged, and three retired guides removed. The Quickstart moves to /quickstart/ and the WAF to SIEM guide to the Firewall and WAF guides group. Retire use-data-stream, associate-domains, select-variables, the Stream data journey page, and Understand Data Stream metrics, whose facts now live on the rewritten pages. Add massive-redirect rows for every moved or retired URL in both languages, rechain older rows, and retarget the in-corpus links and the old Overview anchors to their new pages.
Replace the six-column Transform table, whose long cells clipped and stretched every row, with a scope table for the Option radio and a four-column field table. State the exactly-one rule and its 32002 and 32007 errors once, and note that the defaults are the Console's. Same change on the Portuguese page.
marcus-souza-azion
force-pushed
the
docs/new-data-steam-content
branch
from
October 2, 2026 23:52
06866e1 to
225f160
Compare
marcus-souza-azion
merged commit Oct 3, 2026
bcbe946
into
release/new-azion-docs
5 of 8 checks passed
7 of 14 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What & why
The Data Stream Overview carried four kinds of page in one file: an overview, a settings and variables reference for four data sources and eleven endpoints, a click-through for creating and deleting streams, and a limits table. The Quickstart was a stub with no stages. The guides kept "How to" titles, taught a retired API body, and described a Console form that now filters by workloads, not domains. This PR rebuilds the section on the product section skeleton, in English and Portuguese.
activity_history,workloads,functions_console, andwaf; a stream carries exactly one of a sampling or a workload filter transform; saving a sampled stream deactivates every other stream; the Console filters by workloads; deleting a stream asks for its name; and an Object Storage credential needs the bucket-list capabilities to receive logs. The usage-data guide's GraphQL query, which failed with400, is corrected.**Related issue:**MM-16059
Pages affected: Data Stream,
/documentation/platform/data-stream/and its pages (EN and PT); its guides under/documentation/guides/platform/observability/and the WAF to SIEM guide;src/nav/trees/data-stream.json,src/nav/trees/guides.json,src/nav/trees/real-time-metrics.json,src/nav/redirects.json,cicd/massive-redirect/. 113 files: 22 added (11 English, 11 Portuguese), 81 changed (38 English pages, 37 Portuguese, 6 nav and redirect files), 10 deleted (5 retired pages in each language).Type of change
feat)fix) — typo, broken link, wrong informationdocs) — rewrite, expansion, upkeepi18n)refactor/chore) — reviewed by UXE, no content mixed inAuthor checklist
type(scope): summary(see GOVERNANCE.md §4)title,description,meta_tags,namespace,permalink,last_reviewedpt-brupdated in this PR or follow-upi18npnpm build:local(build + frontmatter check) without errors