-
Notifications
You must be signed in to change notification settings - Fork 545
Add context to "may be out of date" sections #924
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Comments
It's probably worth lifting this caveat from the "high-level overview of the compiler" into "About this guide": https://rustc-dev-guide.rust-lang.org/overview.html#constant-change That way we clearly assert the base case of change initially. This is a good example to reference: Specialization - Additional Resources. Something might have been dated, and is out of the guide's bounds, so it is unlikely to update, but it is given a time it dates to in the guide, so the reader can choose whether or not to click at all. |
@rustbot claim |
Many places in the guide mention "this section may be out of date", such as in the parser. This is unfortunately quite ambiguous because the writer usually has not contextualized it with a "when" or "why", and so the reader does not know how much to trust or mistrust the information. Such comments should be marked with enough data to provide a reasonable amount of context, possibly including but not limited to
The text was updated successfully, but these errors were encountered: