this folder is the public documentation set for ket. it replaces the old monolithic development spec and tracks the current source tree.
- getting-started/installation.md covers installation, builds, and the first local run
- language/overview.md explains the
.ketlanguage 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
- 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