Proceso de RFCs
Para cualquier cosa más grande que un bug fix o un refactor de pocas líneas, pedimos un RFC (Request For Comments).
Cómo escribir uno
- Copiá
docs/rfc/_template.mdadocs/rfc/NNN-short-name.md(el próximoNNNlibre). - Abrí un PR con sólo el RFC, en estado Draft.
- Pedí feedback. Iterá.
- Los maintainers marcan
acceptedorejected. Los PRs de implementación referencian el número de RFC en su descripción.
Por qué lo hacemos así
- El RFC es el diseño. El código es la implementación del diseño. Cuando los dos divergen, actualizamos el RFC.
- El RFC es el changelog de decisiones. Los maintainers futuros pueden leer los RFCs y entender por qué el motor se ve como se ve.
- Los reviewers pueden discutir con texto antes de que nadie haya escrito mil líneas en las que está emocionalmente invertido.
Qué vive en docs/rfc/
Todo RFC aceptado. Ver el índice para la lista completa (vamos por el RFC-020 hoy, con RFC-021 en vuelo para el trabajo de fan-out de lectura).