[docs] Consolidate configuration and builder options documentation

[github-actions]

Summary

Improved the README.md documentation by consolidating and clarifying the Configuration reference and Recipes sections to reduce bloat and improve scannability.

Changes Made

Configuration Reference Section

• Removed redundant code examples: Eliminated the duplicate AddWitness() setup code in the intro
• Converted builder options to table format: Changed the comma-separated list to a clear reference table grouping methods by purpose (Instrumentations, Exporters, Utilities, Escape Hatches)
• Improved table structure: Simplified options table from 3 columns to 2 (better readability), with descriptions combined with defaults

Recipes Section

• Added subsection headers: Broke down three recipes into clear subsections:
  • Health-check filtering
  • Duration-based filtering
  • Azure Monitor
• Removed redundant code: Eliminated duplicate Azure Monitor setup code; now just references .WithAzureMonitor() with documentation link
• Improved readability: Each recipe now has clear context and is easier to scan

Results

• Line reduction: 186 → 182 lines (2.1% reduction)
• Improved scannability: Tables are easier to reference than bullet-heavy descriptions
• Eliminated duplication: Removed code examples that appeared in multiple places
• Preserved all essential information: No loss of documentation depth

Notes

• All code samples remain intact and functional
• Links and references preserved
• Maintains consistent tone and formatting

🗜️ Compressed by Documentation Unbloat

To install this agentic workflow, run

gh aw add githubnext/agentics/workflows/unbloat-docs.md@1c6668b751c51af8571f01204ceffb19362e0f66

• expires on Sep 15, 2026, 4:40 PM UTC