clarify index documentation
clarify index documentation

- formatting and section headings
- moved some content around just a bit
- capitalized Rust in line that was moved up

petgraph/petgraph,bluss/petulant-avenger-graphlibrary