The goal should be RFC-level documentation for everything with references and motivation for all the design choices we've made