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.

Please note that couple of tests are undocumented, I'll notify the developers to fix that before this is accepted.