Improve filenames in doc for better URLs

[greschd]

• avoid index.rst
• use hyphens instead of underscores
• in examples, use "keywords" to make example links generally appealing