Scikit-learn uses the numpy doc string standard and your documentation is generated based on this standard. Thats why the current documentation did not render correctly. See https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt