added: documentation about assertions
added: thread awarness documentation