fixing syntax errors in docs

I've fixed most of the syntax errors in the docs. Also set "template.rst" to be ignored.