asserts added to core functions and api doc updates
doc update