Documentation should use some style-guide convention. Such as http://documentation-style-guide-sphinx.readthedocs.org for Sphinx-based documentations.