fix: don't need this function anymore
doc: update doc and clarify interface
add: field ordering and snippet exits