doc: prose mentioning types should include links to that type

[glandium]

See for example https://doc.rust-lang.org/std/macro.vec!.html

There are many mentions of Vec, like in

Creates a Vec containing the arguments.

and it would really be useful if that linked to the corresponding type.

[steveklabnik]

This is generally true, however, this ticket isn't particularly actionable, since there's no good way to tell if we've got them all or not. As such, I'm going to give it a close, but yes, any PRs to improve linking here is a good thing!

[steveklabnik]

(And, is partially covered by all the "all API docs" metabug)

[glandium]

Is there an type of markdown annotation that would automatically consider those as types? After looking around, it doesn't seem to. On the contrary, it seems one needs to put explicit links manually, as in https://doc.rust-lang.org/src/core/up/src/libcore/any.rs.html#20.

I'd argue it would be nice if rustdoc allowed to annotate things in a way such that types can be linked properly without having to add explicit links to ../../std/(...)

[steveklabnik]

Not currently, but see rust-lang/rfcs#1661