Skip to content

Copy-edit: tighten blog post prose#740

Merged
LadyBluenotes merged 5 commits intoTanStack:ts-intentfrom
KyleAMathews:edit/strunk-white-blog-post
Mar 4, 2026
Merged

Copy-edit: tighten blog post prose#740
LadyBluenotes merged 5 commits intoTanStack:ts-intentfrom
KyleAMathews:edit/strunk-white-blog-post

Conversation

@KyleAMathews
Copy link
Copy Markdown
Contributor

Summary

  • Applied a Strunk & White editing pass to the "From Docs to Agents" blog post
  • Omitted needless words, strengthened verbs, switched to active voice, improved parallel construction
  • No structural, heading, code block, or meaning changes — purely prose tightening

Key edits

  • Tightened the opening paragraph (~30% fewer words, same punch)
  • Replaced passive constructions with active verbs ("Docs are written for" → "Docs target")
  • Cut filler words and hedging ("Meanwhile", "Now", "eventually", "automatically")
  • Improved parallel structure in lists and series
  • Consolidated negative-form statements into positive ones ("You're not maintaining two sources of truth — you're maintaining one" → "You maintain one source of truth")

Test plan

  • Read through edited post for voice/tone consistency
  • Verify no code blocks, image refs, or frontmatter were altered

🤖 Generated with Claude Code

Apply rigorous copy-editing: omit needless words, strengthen verbs,
use active voice, improve parallel construction, and cut flab
throughout the "From Docs to Agents" post.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@netlify
Copy link
Copy Markdown

netlify bot commented Mar 4, 2026

Deploy Preview for tanstack ready!

Name Link
🔨 Latest commit 7b2a326
🔍 Latest deploy log https://app.netlify.com/projects/tanstack/deploys/69a8895be94c54000870f7f1
😎 Deploy Preview https://deploy-preview-740--tanstack.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 25 (🟢 up 5 from production)
Accessibility: 90 (no change from production)
Best Practices: 75 (🔴 down 8 from production)
SEO: 97 (no change from production)
PWA: 70 (no change from production)
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

Cut remaining filler articles, weak futures, redundant context phrases,
and strengthened verb constructions. Fix "Matthews" → "Mathews".

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@KyleAMathews KyleAMathews force-pushed the edit/strunk-white-blog-post branch from 4a3f0de to 563b9eb Compare March 4, 2026 19:28
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@KyleAMathews KyleAMathews force-pushed the edit/strunk-white-blog-post branch from 1d8381f to 9c5c0f4 Compare March 4, 2026 19:30
…out intents, tighten closing

- Rename "Skills as side quests" → "The copy-paste era" to match section content
- Move the training-data version-mixing argument up into the intro section
  where it hits harder, right after the core idea
- Add audience transition sentence between maintainer and consumer sections
- Add concrete YAML example to "From skills to intents" section
- Cut redundant lifecycle summary sentence from closing — end on the
  strong "correct patterns absorbed in real work" line
- Fix all CLI commands to use `npx @tanstack/intent <command>` form

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@KyleAMathews KyleAMathews force-pushed the edit/strunk-white-blog-post branch from a1b3d08 to 7b2a326 Compare March 4, 2026 19:34
@LadyBluenotes LadyBluenotes merged commit 370c2cb into TanStack:ts-intent Mar 4, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants