rust-lang / spec

The Rust specification
Apache License 2.0
103 stars 7 forks source link

Normative vs non-normative or informational content #26

Open ehuss opened 8 months ago

ehuss commented 8 months ago

Should there be a distinction between what is normative and not? How should that be described and delineated? Is that the terminology we want to use?

mattheww commented 8 months ago

As a reader, I like to see a clear distinction between "this is a consequence of the previous rule" and "this is an addition to the previous rule".

mattheww commented 8 months ago

Having explicit markup for non-normative text can be helpful if you want to generate an automatic index of (or reverse links from) defined terms. Then you can let the reader see a list of all uses of the term in normative text.