Skip to content

DOCS-1605 - Add frontmatter descriptions to metrics operators#6679

Open
JV0812 wants to merge 2 commits into
mainfrom
docs-1605-metrics-operators
Open

DOCS-1605 - Add frontmatter descriptions to metrics operators#6679
JV0812 wants to merge 2 commits into
mainfrom
docs-1605-metrics-operators

Conversation

@JV0812
Copy link
Copy Markdown
Collaborator

@JV0812 JV0812 commented May 11, 2026

Purpose of this pull request

This pull request adds comprehensive SEO-friendly frontmatter descriptions to all 24 metrics operator documentation files. These descriptions improve search discoverability and provide clear summaries of metric aggregation and analysis capabilities.

Summary of Changes:

  • Added description: field to frontmatter of 24 metrics operator docs
  • Each description is 49-65 words following Sumo Logic style guidelines
  • Descriptions include operator functionality, grouping capabilities, and use cases
  • Keywords optimized for SEO and search discoverability

Before: Files had no frontmatter descriptions
After: All files have concise, metrics-focused descriptions

Example additions:

  • quantize.md: "Use the quantize metrics operator to control quantization behavior by specifying time bucket size and rollup type..."
  • avg.md: "Use the avg metrics operator to calculate the average value of time series..."
  • topk.md: "Use the topk metrics operator to select the top K time series based on their aggregated values..."

Select the type of change

  • Minor Changes - Typos, formatting, slight revisions
  • Update Content - Revisions, updating sections
  • New Content - New features, sections, pages, tutorials
  • Site and Tools - .clabot, version updates, maintenance, dependencies, new packages for the site (Docusaurus, Gatsby, React, etc.)

Ticket (if applicable)

https://sumologic.atlassian.net/browse/DOCS-1605

Add comprehensive SEO-friendly descriptions to all 24 metrics operator
documentation files. Each description is 49-65 words and includes:
- Clear explanation of operator functionality
- Grouping and aggregation capabilities
- Practical use cases and benefits
- Keywords for improved search discoverability

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@cla-bot cla-bot Bot added the cla-signed Contributor approved, listed in .clabot file label May 11, 2026
@JV0812 JV0812 self-assigned this May 11, 2026
Copy link
Copy Markdown
Collaborator

@kimsauce kimsauce left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you again for adding these descriptions. Had the same comment as the search operator PR: #6677 (comment)

- Trim descriptions to 140-160 characters (Google display limit)
- Remove backticks from description field (plain text only)
- Keep only first 1-2 sentences that capture operator purpose

Addresses PR review feedback on DOCS-1605
@JV0812 JV0812 requested a review from kimsauce May 12, 2026 04:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cla-signed Contributor approved, listed in .clabot file

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants