Skip to content

[docs] Tone scan v8.4: fix 6 marketing language issues in 3 spec files#29772

Merged
pelikhan merged 1 commit intomainfrom
docs/tone-scan-v8-4-2026-05-02-b254844ededfd199
May 2, 2026
Merged

[docs] Tone scan v8.4: fix 6 marketing language issues in 3 spec files#29772
pelikhan merged 1 commit intomainfrom
docs/tone-scan-v8-4-2026-05-02-b254844ededfd199

Conversation

@github-actions
Copy link
Copy Markdown
Contributor

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

Developer Documentation Consolidation

Maintenance tone scan fixing colloquial and promotional language in comparison/analysis documentation files.

Changes Made

  • Analyzed 64 specification files in scratchpad/
  • Fixed 6 tone issues across 3 files
  • Bumped scratchpad/dev.md to v8.4

Files Modified

File Fixes Details
scratchpad/gastown.md 1 "battle-tested" → "with established patterns"
scratchpad/oh-my-code.md 4 Colloquial feature labels in ultrawork section
scratchpad/mdflow-comparison.md 1 "Batteries included" → "Pre-configured defaults"
scratchpad/dev.md Version bump 8.3 → 8.4, history entry added

Tone Fixes Detail

gastown.md:950    "mature, battle-tested architecture"
               → "mature architecture with established patterns"

oh-my-code.md:952  "Zero config: Works out of box with sensible defaults"
               → "Zero configuration: Works with sensible defaults"

oh-my-code.md:953  "Battery included: All tools, agents, hooks pre-configured"
               → "Pre-configured: All tools, agents, and hooks included"

oh-my-code.md:954  "Magic word: Just type `ultrawork` for full power"
               → "Simple invocation: Type `ultrawork` to run all agents"

oh-my-code.md:960  "zero learning"
               → "no configuration required"

mdflow-comparison.md:558  "Batteries included - Built-in defaults for common cases"
                      → "Pre-configured defaults - Built-in defaults for common cases"

Validation

  • All markdown files are valid
  • Mermaid diagrams unchanged
  • Consistent technical tone maintained
  • dev.md version history updated

Review Notes

  1. Fixes apply documentation tone standards consistently to comparison documents (describing third-party tools) as well as gh-aw documentation
  2. No functional content was changed — only presentation language

Generated by Developer Documentation Consolidator · ● 756.1K ·

  • expires on May 4, 2026, 2:00 PM UTC

Maintenance tone scan fixing colloquial/promotional language in comparison
and analysis documentation files (gastown.md, oh-my-code.md,
mdflow-comparison.md). Bumps dev.md to v8.4.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions github-actions Bot added automation documentation Improvements or additions to documentation labels May 2, 2026
@pelikhan pelikhan merged commit 4439f82 into main May 2, 2026
@pelikhan pelikhan deleted the docs/tone-scan-v8-4-2026-05-02-b254844ededfd199 branch May 2, 2026 15:03
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.

1 participant