README: Add additional links section
Enhance docstrings in MOC class

Includes the addition of doctests to illustrate the usage
of some of the features.
README: Add a note on how to run the doctests