Skip to content

docs: rewrite README problem section for clarity#43

Merged
liam-machine merged 1 commit into
mainfrom
ship/readme-problem-rewrite
May 8, 2026
Merged

docs: rewrite README problem section for clarity#43
liam-machine merged 1 commit into
mainfrom
ship/readme-problem-rewrite

Conversation

@liam-machine
Copy link
Copy Markdown
Owner

Summary

  • Tighten the problem section from three paragraphs (~190 words) to three explicit bullets (~110 words).
  • Bullets now name the actual reasons ERD Studio exists: dbt-ERD sync drift, no per-domain dbt tagging for independent refresh schedules, and SqlDBM-style tools not being AI-readable.
  • Plainer language for non-technical readers while keeping dbt prominent.

Test plan

  • Open README.md preview and confirm the new problem section flows into the existing "## The solution" heading
  • Verify all three reasons are clearly distinguishable to a non-technical reader

🤖 Generated with Claude Code

Tighten the problem statement from three paragraphs to three explicit
bullets covering the actual reasons users reach for ERD Studio over
existing tools: dbt-ERD sync drift, lack of per-domain dbt tagging
for independent refresh schedules, and SqlDBM-style tools not being
AI-readable. Plainer language for non-technical readers.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@liam-machine liam-machine merged commit b159dad into main May 8, 2026
2 checks passed
@liam-machine liam-machine deleted the ship/readme-problem-rewrite branch May 8, 2026 21:46
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.

1 participant