Added notes to API and to test
Added exception throw samples