Documentation Standard

Documentation must describe the current branch rather than planned APIs.

Structure

• Localized documentation lives under doc/en_US, doc/zh_CN, and doc/ja_JP.
• English is the structural baseline; translations keep matching relative paths.
• Each documented package uses api.md, design.md, and tutorial.md.
• README.mbt.md gives a short package-local entry point.
• pkg.generated.mbti is authoritative for MoonBit public signatures.

Responsibilities

• api.md lists callable behavior and observable results.
• tutorial.md shows the shortest realistic workflow.
• design.md records ownership, invariants, effects, and explicit limitations.
• verification.md records reproducible evidence without overstating coverage.

Commands, identifiers, package paths, schema names, and version numbers remain unchanged across translations. A capability must not be documented as complete until code and focused tests exercise it.