code styling in docs

based on what is suggested here http://documentation-style-guide-sphinx.readthedocs.org/en/latest/style-guide.html