fix documentation syntax errors / warnings
Merge branch 'master' into feature/fep2

Conflicts:
	docs/index.rst