docs
added ipython directives, and converting docs to ipython-like
following sampledoc from mpl