document the editor public API, reorder the functions