Move rustdoc.md into the book

[Hoverbear]

It would be good to move this into the book. It might also be helpful to newcomers to talk about the scoping in the documentation tests as that was a big stumbling block for me.

@steveklabnik