use rst extensions for editability and RTD links
remove dupe toc; add header links; make 'What it does' first