docs and annotations
added doc section to the readme