I just found out about this newish feature and want to get a sense of how ready it is for release of public crates. Are any crates released that use it already? I'm hoping to see it working all the way through docs.rs but can't find an example.
If you also missed it, here is a quick summary of this rustdoc feature, which I believe was introduced in rust 1.25, though it didn't make any release notes I can find, nor it is mentioned in the rust book. Where as we used to have to do things like the following for intra-rustdoc links:
/// types: [`BodySink`](struct.BodySink.html) /// functions: [`from_file`](#method-from_file)
We can now do the following, for simple implicit links:
/// types: [`BodySink`] /// functions: [`BodyImage::from_file`]
Or when necessary to disambiguate, as per normal rust paths:
/// types: [`BodySink`](body_image::BodySink) /// functions: [`from_file`](BodyImage::from_file)
In addition to much more intuitive syntax, unresolvable link paths are treated as errors, which is potentially a great help to avoid broken links. See above linked tracking issue and the original RFC for much more detail.
Also, anyone tested how or if this will play with the 2018 Edition, path clarity changes? My current intuition is to update links as part of upgrades to the 2018 edition, though I should also try that myself on a recent nightly.