Tsumugu#
Tsumugu turns a directory of Markdown, MDX, and HTML files into a documentation site. There is no configuration file: routes and navigation come from the files.
Read the guide#
The usage guide is written twice, once in each language. Both cover the same ground, and every page links to its counterpart.
Everything else here is a design record#
The rest of this site is not a manual. It is how Tsumugu was designed and why, kept beside the code so a decision can be checked rather than remembered.
Designs — the architecture, the constraints it holds to, and the operating policies that follow from them.
Decisions — accepted ADRs, each with the alternatives that were rejected and the reason.
RFCs — proposals still waiting on agreement or evidence.
These pages are in English only, and they describe intent rather than usage. If you are here to use Tsumugu, the guide above is all you need.