Add goal for expansion of the Rust Reference #336
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
tshepang
reviewed
Jul 16, 2025
tshepang
reviewed
Jul 16, 2025
tshepang
reviewed
Jul 16, 2025
|
Glad to see this goal proposed @joshtriplett . Thanks for putting it together. |
Co-authored-by: Tshepang Mbambo <[email protected]>
joshtriplett
force-pushed
the
reference-expansion
branch
from
bba79d8 to
420ae81
Compare
traviscross
reviewed
Jul 17, 2025
Co-authored-by: Travis Cross <[email protected]>
traviscross
reviewed
Jul 17, 2025
…ce processes Based on joint iteration by @traviscross and @joshtriplett. The new text addresses all the same concerns as the old text (notably making sure that we don't let the perfect become a blocker on the good), but lays out much more detailed processes, and avoids potentially incorrect or misleading implications about the normativity of the reference. Co-authored-by: Travis Cross <[email protected]>
traviscross
approved these changes
Jul 17, 2025
lqd
reviewed
Jul 18, 2025
| | Task owners | <!-- TASK OWNERS --> | | ||
| | Status | Proposed | | ||
| | Zulip channel | [#t-spec][channel] | | ||
| | Tracking issue | [rust-lang/rust-project-goals#NNN] | |
There was a problem hiding this comment.
Suggested change
| | Tracking issue | [rust-lang/rust-project-goals#NNN] | | |
| | Tracking issue | | |
|
|
||
| ## Summary | ||
|
|
||
| The Rust Reference (https://doc.rust-lang.org/nightly/reference/) describes and |
There was a problem hiding this comment.
mdbook won't linkify these otherwise
Suggested change
| The Rust Reference (https://doc.rust-lang.org/nightly/reference/) describes and | |
| The Rust Reference (<https://doc.rust-lang.org/nightly/reference/>) describes and |
| - The behavior of the borrow checker. This is extensive work that has been the | ||
| subject of PhD theses. There have been multiple attempts to document and | ||
| bound the behavior of the borrow checker, the latest of which is Tree Borrows | ||
| ( https://www.ralfj.de/blog/2023/06/02/tree-borrows.html ) by Ralf Jung, a |
There was a problem hiding this comment.
Suggested change
| ( https://www.ralfj.de/blog/2023/06/02/tree-borrows.html ) by Ralf Jung, a | |
| ( <https://www.ralfj.de/blog/2023/06/02/tree-borrows.html> ) by Ralf Jung, a |
| in the future. | ||
| - The operational semantics of the Rust language, which includes the work | ||
| formerly described as "unsafe code guidelines". This has been the focus of | ||
| the opsem team (https://github.com/rust-lang/opsem-team). |
There was a problem hiding this comment.
Suggested change
| the opsem team (https://github.com/rust-lang/opsem-team). | |
| the opsem team (<https://github.com/rust-lang/opsem-team>). |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
As discussed in T-spec meetings.
Rendered