docs

this folder is the public documentation set for ket. it replaces the old monolithic development spec and tracks the current source tree.

start here

• getting-started/installation.md covers installation, builds, and the first local run
• language/overview.md explains the .ket language surface and its current limits
• usage/cli.md documents the cli commands, backend selection, config sources, and playground entry point
• codebase/architecture.md explains the compiler pipeline and repository layout
• project/open-source.md summarises maintainer, licence, and commit hygiene

documentation rules

• keep headings in lower-case
• prefer British English in public-facing docs
• document current behaviour rather than planned behaviour
• link to source directories and examples when a topic needs code context