(sirois and i worked on an internal doc for this, but since then i've realized why something like https://github.com/jsirois/sapling is important)