Skip to content

[docs] docs: reduce README bloat — condense bullets, remove duplicate recipe#20

Draft
github-actions[bot] wants to merge 1 commit into
mainfrom
docs/unbloat-readme-2fccfc36c6e36537
Draft

[docs] docs: reduce README bloat — condense bullets, remove duplicate recipe#20
github-actions[bot] wants to merge 1 commit into
mainfrom
docs/unbloat-readme-2fccfc36c6e36537

Conversation

@github-actions

Copy link
Copy Markdown
Contributor

Improves README.md by removing duplicated content and converting bullet-heavy sections to concise prose.

Changes

File: README.md — 440 → 385 lines (55 lines removed, ~12.5% reduction)

Bloat removed

Type Detail
Duplicate recipe Removed the "Add custom resource attributes" <details> recipe — both its JSON snippet and code snippet are already shown in the Configuration reference section
Bullet list → prose IWitness<T> section: 3-bullet list + 2 explanatory sentences condensed to one sentence
Bullet list → prose WitnessedAction outcomes: 3-bullet list condensed to a single inline sentence
Bullet list → prose Design philosophy: 4-bullet list condensed to two-sentence prose
Redundant subsections WS0001 "Install the analyzer" and "Configure severity" subsections folded into inline prose (content preserved)

Content preserved

All essential information is retained — the removed recipe's content is already covered by the Configuration reference section directly above it. Links, code examples, and technical details are unchanged.

🗜️ Compressed by Documentation Unbloat

To install this agentic workflow, run

gh aw add githubnext/agentics/workflows/unbloat-docs.md@1c6668b751c51af8571f01204ceffb19362e0f66
  • expires on Jul 18, 2026, 2:42 PM UTC

- Condense IWitness<T> bullet list to inline prose
- Condense WitnessedAction outcome bullets to single sentence
- Condense design philosophy bullets to inline prose
- Remove 'Add custom resource attributes' recipe (duplicates configuration reference section)
- Fold WS0001 install/severity subsections into prose

440 → 385 lines (55 lines removed, ~12.5% reduction)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions github-actions Bot added automation documentation Improvements or additions to documentation labels Jul 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automation documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants