Skip to content

[docs] docs: remove redundant bullets in cost-management episode cost section#29818

Merged
pelikhan merged 1 commit intomainfrom
docs/unbloat-cost-management-da65c1c6be0e2ae3
May 2, 2026
Merged

[docs] docs: remove redundant bullets in cost-management episode cost section#29818
pelikhan merged 1 commit intomainfrom
docs/unbloat-cost-management-da65c1c6be0e2ae3

Conversation

@github-actions
Copy link
Copy Markdown
Contributor

@github-actions github-actions Bot commented May 2, 2026

Summary

  • File improved: docs/src/content/docs/reference/cost-management.md
  • Bloat removed: 11 bullet points eliminated (23% bullet reduction), 17 lines removed (5.3% line reduction) from 319-line file
  • All essential information preserved: field names, descriptions, and context retained

Changes Made

1. Removed redundant "Practical guidance" bullets (3 bullets)

The section contained three bullets explaining when to use .runs[], .episodes[], and .edges[] arrays. This was a third repetition of the same information already stated in:

  • The bullet list above it ("The system already groups related runs and emits both views")
  • The prose immediately before ("If you are trying to answer 'what did this job really cost end-to-end?', read the episode view...")
  • The sentence just before the section ("Use .edges[] when you need to inspect why runs were grouped together")

2. Condensed "Useful repo-level summary fields" from 12 lines to 2 lines (8 bullets → prose)

The original section listed 8 bare field names with no descriptions — the lowest quality reference material in the file. These names were moved into an inline prose sentence that:

  • Preserves all 8 field names for discoverability
  • Integrates the "episode view rolls these up" note naturally
  • Eliminates a low-quality undescribed bullet list

Screenshots

The documentation server returned HTTP 200 for the modified page at /gh-aw/reference/cost-management/. Visual screenshots were unavailable due to network isolation in this AWF execution environment (Playwright container cannot reach the agent container's bridge IP — known AWF configuration constraint).

Blocked Domains

Not applicable — screenshots could not be captured due to network isolation.


References: §25259515081

🗜️ Compressed by Documentation Unbloat · ● 868.5K ·

  • expires on May 4, 2026, 7:21 PM UTC

Remove 11 bullet points (23% reduction) that duplicated information
already present in the surrounding prose:
- "Practical guidance" bullets repeated what lines 98-100 already say
- "Useful repo-level summary fields" bare name list condensed to prose

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions github-actions Bot added automation doc-unbloat documentation Improvements or additions to documentation labels May 2, 2026
@pelikhan pelikhan marked this pull request as ready for review May 2, 2026 19:41
Copilot AI review requested due to automatic review settings May 2, 2026 19:41
@pelikhan pelikhan merged commit e1a6f33 into main May 2, 2026
3 checks passed
@pelikhan pelikhan deleted the docs/unbloat-cost-management-da65c1c6be0e2ae3 branch May 2, 2026 19:41
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR streamlines the cost-management reference docs by removing redundant list formatting and consolidating repeated guidance in the episode-cost section.

Changes:

  • Removed a repeated “Practical guidance” bullet list from the episode-cost explanation.
  • Collapsed the repo-level safe-output summary field list into a single prose sentence.
  • Kept the same section focused on episode, run-level, and repo-level cost-analysis fields.
Show a summary per file
File Description
docs/src/content/docs/reference/cost-management.md Simplifies the episode cost-analysis documentation by deleting repeated bullets and compressing repo-level field references into prose.

Copilot's findings

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

  • Files reviewed: 1/1 changed files
  • Comments generated: 1

Comment on lines +125 to 126
Repo-level aggregate fields available: `runs_with_temporary_id_chains`, `runs_with_delegated_temp_targets`, `runs_with_missing_temporary_id_map`, `runs_with_invalid_temporary_id_map`, `total_temporary_id_mappings`, `total_chained_targets`, `total_chained_followup_actions`, and `total_closed_temp_targets`. These also roll up onto `.episodes[]` for per-execution chain intensity analysis.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automation doc-unbloat documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants