The suggestions API was introduced in April 2015
(rust-lang/rust@906a9728ff), long predating rustfix (initial commit July
2016) or editions (RFC 2052 approved September 2017).
We don't want to leave the impression that spans are about making it
easier for compiler developers to perform the arduous task of emitting
an error; spans are about pointing to particular segments of code in the
emitted error messages. Also, we don't need to say "whenever an error
comes up"; that's implied by the phrase "error reporting."
It's unfortunate that `code-monospaced` links don't render with link
colors (such that the reader needs to hover over them just to tell that
it is a link), but that's presumably a bug in MdBook, and not something
we need concern ourselves with here.
Sébastien Duquette
mark
Zack M. Davis