document fixup! and a preliminary guide how to add new leaf frame types