DOC: writing documentation examples
DOC: add doc string examples
DOC: unit test fixing