Keep Readme short and readble. The doc should be fully contained in the
MATLAB code of each function/class.

This commit also adds details on how to use classes and the description
of the Polar class.