This documents the current thinking on the custom editor api. The current api proposal is not actually implemented yet