fix: revamped remaining top traffic pages#370
Merged
Conversation
Manazsharma
approved these changes
May 22, 2026
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.
Summary
Applies a consistent gold-docs treatment across the highest-traffic pages in the docs. Focus is on structure, correctness, and discoverability — content meaning is preserved.
Patterns applied across every page:
title:+description:frontmatter---section separators removed.mdextensions andindex.mdfor directory targets!!!admonitions!!! tip "Video walkthrough"admonitionsPages touched
docs/administration/maintenance/storage-management/storage.mdZO_LOCAL_MODE), heading casing fixes (OpenStack Swift, Aliyun, Azure Blob), GCS bold pseudo-headings promoted to####docs/enterprise-setup/performance.md!!! noteadmonitions, all>Note:blockquotes converted to admonitions, Next steps addeddocs/enterprise-setup/sre-agent.md???collapsible (5 numbered issues inside), Prerequisites enriched with quota note +O2_AI_ENABLEDrequirement, standard footerdocs/features/enterprise.mddocs/features/metrics.mddocs/ingestion/logs/syslog.md??? "Legacy reference (pre-August 2025)"so the deprecation warning leads the page,shell→bashfences, video in tip admonitiondocs/ingestion/logs/vector.md( .toml format)artifact removed,### NOTEheading-as-note converted to admonition, placeholder substitution + sink-type picker added, Verify Ingestion + Next steps sectionsdocs/ingestion/traces/opentelemetry.mdTypeScript,JavaScript (Node.js),OpenTelemetry), trace ingestion endpoint section added, Prerequisites, Next stepsdocs/integration/ai/mcp/index.md!!! noteadmonitions retitled, multi-org section clarified for all clients, "Resources" replaced with proper Next steps + standard footerdocs/overview/comparison.md## Elasticsearch Compatibilitystandalone section folded into the Elasticsearch comparison with a sentence on why it mattersdocs/reference/api/.pagesOverview: index.mdso the API Reference landing page appears in the navdocs/reference/api/index.md>blockquote-as-code auth examples converted to fenced code blocks, all sub-links given.md/index.mdextensions, Next stepsdocs/reference/api/search/search.md{stream}placeholder note, duplicate "Query latest 10 record logs" example removed, English typos fixed (filed→field,Something need highlighted:→Notes:), Next stepsdocs/reference/sql-functions/full-text-search.md---separators removed, all<br>tags stripped, function index table added at top,!!! Note→!!! note, MCP-style consistency tweaks, pattern types undermatch_allconverted to a 3-column table,**Important**inline note promoted to!!! warning, Next stepsdocs/reference/sql-functions/index.mdapprox_topk,approx_topk_distinct), proper link extensions, standard footerdocs/releases.mddocs/user-guide/analytics/alerts/index.md---separators removed, "Learn more" →## Next steps, trailing-slash directory paths fixedTests ran on local