I see in this issue about intra-doc links for
false that rustdoc doesn't currently support intra-doc links for keywords in general, and it seems several folks were pretty strongly against it. I'm curious what the rationale is?
In working on the API docs for Neon, which is a library that specifically tries to cater to new Rust programmers, and I'd like to be able to link to the
move keyword in the standard API docs to explain common usage patterns like spawning threads with a
I can of course hard-code the link to the official URL, but not having support from the tooling the way primitive types do makes me wonder if I'm doing something that's considered bad practice. Our docs already use intra-doc links for things like
reference, so I was surprised when
move didn't work.
Looking forward to hearing folks' thoughts, thanks!