Reorganising docstrings and integration with SoCo class

--HG--
extra : amend_source : adf49c81bee11daf83fb81f089ea4009345caed7