Added documentation and fixed markup in the doc string