[docs] Update documentation for features from 2026-05-22

[github-actions]

Summary

Documentation update for OpenTelemetry custom span attributes feature. This PR adds comprehensive documentation for the observability.otlp.attributes configuration field and the attributes frontmatter field, enabling users to attach custom key-value metadata to OTLP spans using GitHub Actions expressions.

Change Classification

• Type: Documentation
• Scope: OpenTelemetry observability configuration
• Breaking Changes: None
• Impact Level: Medium

Files Changed

Modified Files (2)

1. docs/src/content/docs/reference/frontmatter.md

   • Change Type: Documentation addition
   • Summary: Added documentation for the optional attributes field supporting custom span attributes with GitHub Actions expressions
   • Impact: Low
   • Breaking: No
   • Key Changes:
     • Documented new attributes frontmatter field
     • Added examples showing GitHub Actions expression usage

2. docs/src/content/docs/reference/open-telemetry.md

   • Change Type: Documentation addition
   • Summary: Documented the observability.otlp.attributes configuration field, added environment variable GH_AW_OTLP_ATTRIBUTES, and created a new "Custom span attributes" section with usage examples
   • Impact: Medium
   • Breaking: No
   • Key Changes:
     • Added observability.otlp.attributes configuration field documentation
     • Documented GH_AW_OTLP_ATTRIBUTES environment variable
     • Created new section: "Custom span attributes" with practical examples
     • Showed workflow-level and job-level attribute configuration patterns

Technical Details

Feature Documentation Added

• Configuration Path: observability.otlp.attributes
• Frontmatter Field: attributes
• Environment Variable: GH_AW_OTLP_ATTRIBUTES
• Value Type: Key-value pairs supporting GitHub Actions expressions
• Use Case: Attach custom metadata to OpenTelemetry spans for enhanced observability and filtering

Documentation Structure

• Reference documentation updated in two locations:
  • Frontmatter reference (field-level documentation)
  • OpenTelemetry reference (feature-level documentation with examples)

Commit History

• 38e543737 - docs: document observability.otlp.attributes custom span attributes

Metadata

• Repository: github/gh-aw
• PR Number: [docs] Update documentation for features from 2026-05-22 #33984
• Title: [docs] Update documentation for features from 2026-05-22
• Files Modified: 2
• Total Impact: Medium (documentation-only change)
• Breaking Changes: None
• Test Requirements: None (documentation only)

Agentic Analysis Tags

{
  "category": "documentation",
  "subcategory": "reference",
  "features_documented": ["observability.otlp.attributes", "frontmatter.attributes"],
  "components_affected": ["opentelemetry", "frontmatter"],
  "requires_code_review": false,
  "requires_test_validation": false,
  "breaking_change": false,
  "api_changes": false,
  "config_changes_documented": true,
  "user_facing": true,
  "observability_related": true
}

Generated by PR Description Updater for issue #33984 · ● 789.3K · ◷