Update docs index to use lists

Also include a missing link to the rustdoc manual
auto merge of #11588 : am0d/rust/dox, r=brson

This is a bit cleaner and means we don't need whitespace at the end of each line to force line breaks.