Skip to content

docs(readme): rewrite the GitHub front page in a human voice with deeper feature detail#69

Merged
DavidBabinec merged 1 commit into
mainfrom
docs/readme-rewrite
Jun 17, 2026
Merged

docs(readme): rewrite the GitHub front page in a human voice with deeper feature detail#69
DavidBabinec merged 1 commit into
mainfrom
docs/readme-rewrite

Conversation

@DavidBabinec

Copy link
Copy Markdown
Contributor

What changed

A full rewrite of README.md, the GitHub front page. The previous copy read as generic AI marketing prose; this replaces it with plainer, more human writing and goes deeper on what the product actually does.

Section by section:

  • Opening — new anti-stack framing ("a modern site usually means assembling a stack…"). Drops the WordPress-vs-Webflow trope entirely.
  • Deploy in one click — replaced the stacked deploy buttons with a provider table. Railway (SQLite + Postgres) is marked Recommended; Render, Fly.io, DigitalOcean are listed as Coming soon for the one-click templates planned next.
  • One tool, the whole life of a site — the five pillars (Design / Build / Manage / Analyze / Extend) rewritten with roughly 2× the concrete detail: typed Visual Component params + slots, the 28-tool BYO-model AI agent, Super Import, 36-capability access control + TOTP MFA, the QuickJS-WASM plugin sandbox, and more.
  • Data workspace — new dedicated bullet under Manage: custom post types and custom data tables, form-submission collection, lightweight CRM use, and tables as loop content sources.
  • Publisher — reframed around speed and the three-layer pipeline (baked static → render cache → ~0.7 kB per-visitor holes). Removed the not-credible "builder attributes everywhere" claim.
  • Quick start / Who's behind this / For developers / Thanks / License — same information, de-slopped voice.
  • Roadmap heading renamed This is the inceptionEarly, on purpose; the two in-page anchors that point at it were updated to #early-on-purpose.

Why

The README is the product's storefront. The old copy didn't sound human and undersold the breadth of features. This makes it read like a person wrote it and surfaces more of what Instatic can do.

Impact

Docs only. No code, no behavior change. Image paths, badges, and layout wrappers are unchanged.

Verification

Prose/markdown change only — reviewed rendered structure and confirmed internal anchors (#deploy-in-one-click, #quick-start, #early-on-purpose) resolve. No build/test impact.

🤖 Generated with Claude Code

…per feature detail

Replace the AI-flavored marketing copy with plainer, more human prose and
expand the feature coverage. Highlights:

- New anti-stack opening; drops the WordPress-vs-Webflow framing.
- Deploy section is now a provider table (Railway recommended; Render,
  Fly.io, DigitalOcean marked coming soon for future one-click templates).
- Deeper feature pillars (Design/Build/Manage/Analyze/Extend), including a
  dedicated Data workspace bullet (custom post types, custom tables, form
  collection, CRM, loop sources).
- Publisher section reframed around speed + the three-layer pipeline.
- Roadmap heading renamed 'This is the inception' -> 'Early, on purpose';
  in-page anchors updated to match.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@DavidBabinec
DavidBabinec marked this pull request as ready for review June 17, 2026 11:52
@DavidBabinec
DavidBabinec merged commit 8e01106 into main Jun 17, 2026
6 checks passed
@DavidBabinec
DavidBabinec deleted the docs/readme-rewrite branch June 30, 2026 23:43
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