Skip to content

Commit daf2d7d

Browse files
committed
Make it clear that the reference isn't normative
Any time someone edits the reference, it has to be taken very seriously, since it's the closest thing we have to a specification. This commit adds language which indicates that this is not a normative document, which makes it easier to make tweaks without worrying about forever harming the future of Rust by painting ourselves in a corner.
1 parent d1df3fe commit daf2d7d

File tree

1 file changed

+5
-0
lines changed

1 file changed

+5
-0
lines changed

src/doc/reference.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,11 @@ separately by extracting documentation attributes from their source code. Many
2121
of the features that one might expect to be language features are library
2222
features in Rust, so what you're looking for may be there, not here.
2323

24+
Finally, this document is not normative. It may include details that are
25+
specific to `rustc` itself, and should not be taken as a specification for
26+
the Rust language. We intend to produce such a document someday, but this
27+
is what we have for now.
28+
2429
You may also be interested in the [grammar].
2530

2631
[book]: book/index.html

0 commit comments

Comments
 (0)