improved api layout
extended docs (screenshots added)