docs update

Update and rst markup.

Tutorial is implemented as dev guide

For some strange reason, module variables and class attributes doc strings dont appear ;-(