Saltearse al contenido

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

  1. Copiá docs/rfc/_template.md a docs/rfc/NNN-short-name.md (el próximo NNN libre).
  2. Abrí un PR con sólo el RFC, en estado Draft.
  3. Pedí feedback. Iterá.
  4. Los maintainers marcan accepted o rejected. 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).

Ver también