README

docsstackrfcs

Aggregation point for architectural RFCs that govern the Koder Stack.

Convention

Each RFC lives *n the module it belongs to* under that module's own rfcs/ directory. Examples:

  • platform/kdb/rfcs/RFC-001-kdb-next.md — kdb-next Rust rewrite, TiKV substrate, hyperscale tenants
  • platform/id/v2/rfcs/RFC-001-*.md — Koder ID v2 from-scratch IAM

This directory (docs/stack/rfcs/) aggregates them *ia symlinks*so the stack PDF can include them all in one appendix without duplicating content. The canonical source is always the file inside the module — never edit a symlink.

How to add an RFC

  1. Write the RFC in its home module, e.g. platform/kdb/rfcs/RFC-007-foo.md.
  2. From docs/stack/rfcs/, create a symlink with a prefixed name so RFCs sort by module:
    ln -s ../../../platform/kdb/rfcs/RFC-007-foo.md kdb-RFC-007-foo.md
  3. Include it in build/technical.typ under the = Appendix — RFCs heading (Typst's #include or #read can pull the markdown text).
  4. Rebuild the PDFs.

Current RFCs

No RFCs symlinked yet. When modules start writing formal RFCs under their own rfcs/ directories, link them here.

Source: ../home/koder/dev/koder/meta/docs/stack/rfcs/README.md