Skip to content

docs(readme): refresh top — website-platform vision + v2.0 feature inventory#52

Merged
thunpisit merged 1 commit into
mainfrom
docs/readme-website-platform-refresh
May 3, 2026
Merged

docs(readme): refresh top — website-platform vision + v2.0 feature inventory#52
thunpisit merged 1 commit into
mainfrom
docs/readme-website-platform-refresh

Conversation

@thunpisit

Copy link
Copy Markdown
Contributor

Summary

The intro/Why/Features at the top of the README had drifted hard: framed Khao Pad as a CMS, listed only v1.0 features. After 11 shipped milestones (v1.0 → v2.0) it undersold the project to anyone who didn't already know what was in it.

Surgical changes (top ~80 lines)

  • Tagline now matches the marketing site's positioning: "The open-source website platform for Cloudflare."
  • Added demo + marketing site links under the tagline
  • New "What it is" section: CMS → platform arc in two sentences
  • "Why?" table grew a row (Ghost/Wagtail), closing line names the free-tier value
  • "What ships" replaces the old 4-bullet feature list with a five-pillar inventory covering every shipped milestone — every feature an editor would ask about appears here
  • "Platform fundamentals" closes with architectural promises

What stayed

Mid-section is still accurate and complete:

  • Architecture diagram
  • Tech Stack
  • Using Khao Pad in your project (Setup)
  • Bindings + Deployment + Config reference
  • Roadmap table (already had all 11 versions ✅ Shipped)
  • License

Test plan

  • wc -l shows 363 lines (was 299), all additions in the top
  • Roadmap table intact (11 rows preserved)
  • No code changes; doc-only PR

🤖 Generated with Claude Code

…eature inventory

The intro/Why/Features sections were stale: still framed Khao Pad as
"a CMS for Cloudflare" and listed only the M1–M7 (v1.0) feature set.
After 11 shipped milestones (v1.0 → v2.0) the README undersold the
project to anyone who didn't already know what was in it.

Refresh:

- New header tagline: "The open-source website platform for
  Cloudflare." Mirrors the marketing site's positioning since the
  v1.5 → v1.6 pivot.
- Added live-demo + marketing-site links right under the tagline.
- New "What it is" section explains the CMS-→-platform arc in two
  sentences.
- "Why?" table grew a row (Ghost / Wagtail) and the closing line
  mentions the free-tier point explicitly.
- "What ships" replaces the old four-bullet feature list with a
  five-pillar inventory (content, discoverability, IA, insight,
  performance, engagement) covering every shipped milestone — every
  feature an editor would ask about appears here.
- "Platform fundamentals" closes with the architectural promises
  (one repo, multilingual, Better Auth, pluggable storage, real
  staging/prod).

Mid-section (Architecture, Tech Stack, Setup, Bindings, Deployment,
Roadmap, License) untouched — those were already accurate and
complete.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@thunpisit thunpisit merged commit b8f1ae7 into main May 3, 2026
@thunpisit thunpisit deleted the docs/readme-website-platform-refresh branch May 3, 2026 11:56
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