Skip to content

docs: terminology update and skill renames#14

Merged
ignsm merged 3 commits intomainfrom
docs/terminology-update
Apr 7, 2026
Merged

docs: terminology update and skill renames#14
ignsm merged 3 commits intomainfrom
docs/terminology-update

Conversation

@ignsm
Copy link
Copy Markdown
Owner

@ignsm ignsm commented Apr 7, 2026

Summary

  • Replace "JSON schema" with "form definition" across all docs, README, and CONTRIBUTING to avoid confusion with the JSON Schema spec (draft-07/2020-12)
  • Rename /form-schema/formhaus-create-form and /figma-connect/formhaus-figma-connect for discoverability
  • Add "Nested keys" section to fields guide and "Schema improvements" list to CONTRIBUTING

What changed

Terminology (all prose, zero code):

  • "JSON-schema-driven" → "form engine with its own compact JSON-based definition format"
  • All docs pages, VitePress config, README, CONTRIBUTING updated
  • docs/api/schema.mddocs/api/definition.md
  • TypeScript types (FormSchema, schema prop) intentionally unchanged

Skill renames:

  • .claude/skills/form-schema/.claude/skills/formhaus-create-form/
  • .claude/skills/figma-connect/.claude/skills/formhaus-figma-connect/
  • All guide pages and cross-links updated

Added:

  • docs/guide/fields.md: "Nested keys" section explaining flat key behavior

What did NOT change

  • No TypeScript types renamed (FormSchema, schema prop stay as-is for now)

ignsm added 3 commits April 7, 2026 23:34
Rename terminology from JSON schema to form definition to avoid
confusion with the JSON Schema spec (draft-07/2020-12). Updates
README, CHANGELOG, VitePress docs site, and all guide pages.
Include package name in skill names for discoverability.
Update skill files, guide pages, VitePress sidebar, and all
cross-references.
Explain flat key behavior in fields guide. Add non-urgent
improvement ideas (disabled, readonly, multiple validators,
field groups) to CONTRIBUTING.
@vercel
Copy link
Copy Markdown

vercel bot commented Apr 7, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
formhaus Ready Ready Preview, Comment Apr 7, 2026 2:39pm

@ignsm ignsm merged commit 2cf9336 into main Apr 7, 2026
3 checks passed
@ignsm ignsm deleted the docs/terminology-update branch April 10, 2026 14:55
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