Skip to content

Refine HTML pages low-code quickstart entry and examples#54

Draft
basteks wants to merge 1 commit into
mainfrom
html-pages-quickstart-refinements
Draft

Refine HTML pages low-code quickstart entry and examples#54
basteks wants to merge 1 commit into
mainfrom
html-pages-quickstart-refinements

Conversation

@basteks

@basteks basteks commented Jul 24, 2026

Copy link
Copy Markdown
Collaborator

Round-2 refinements to the HTML pages docs, addressing review remarks on the published (round-1) pages. Draft — pending final sign-off; ready to mark ready + merge once approved.

What changed (2 files)

docs/html-pages/low-code-quickstart.md

  • Bumpy entry (remark 1). Renamed the What this page does heading (dangling "this") to The example: an event sign-up page, and added a bridge paragraph framing the sign-up page as a worked example whose read→show→write loop a plain form / list / info page is a subset of.
  • Two smaller shapes section — two tiny, complete, runnable pages that are the sign-up example minus a half: a write-only feedback form (no loadTable) and a read-only list (no form). Makes the "subset" idea concrete for the three use cases named in the intro. Illustrative, so no companion ZIP.
  • Removed the How it works (the mental model) section (moved to the overview).

docs/html-pages/index.md

  • Added an approach-neutral How a page is built section (three parts: look / SDK / connection; single file vs modular is just organisation), where the mental model now lives.
  • Relaxed the "written for developers" intro line, since the page fronts both the low-code and developer approaches.

Notes for reviewers

  • No changes to the SDK reference, getting-started.md, example.md, or the downloadable quickstart index.html/ZIP — the main code block is untouched.
  • Both embedded skeleton pages pass node --check.

🤖 Generated with Claude Code

- index.md: move the look/SDK/connection mental model here as an
  approach-neutral "How a page is built" section; relax the
  "written for developers" intro line since the page fronts both approaches.
- low-code-quickstart.md: rename "What this page does" (dangling "this")
  to "The example: an event sign-up page"; add a bridge paragraph framing
  the sign-up page as a worked example whose loop a plain form / list / info
  page is a subset of; remove the "How it works" section (now on overview).
- low-code-quickstart.md: add a "Two smaller shapes" section with two tiny,
  complete pages (a write-only form, a read-only list) making the subset
  idea concrete.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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