doc: Clarify that an error is a compiler error

This was asked on HN, and it's easy to clarify.
auto merge of #15308 : brson/rust/intro, r=alexcrichton

This was asked on HN, and it's easy to clarify.