Fix rustdoc and add tests for rustdoc integrity

[elkowar]

This PR adds a test to verify that rustdoc is happy and fixes current broken rustdoc links

[buffet]

Also docs: not doc:.