Few improvements

o updates description
o improves the base api
o fixes convenient api tasks
o updates documentation
o also add improvements to the annotation features