Add run_check_index_rst.py and improve documentation

This patch adds `run_check_index_rst.py` helper, which checks all
existing files and it's documentation. This check is added in .travis.yml
and will be executed with each test.

Signed-off-by: Lukáš Doktor <ldoktor@redhat.com>