-
Notifications
You must be signed in to change notification settings - Fork 2.6k
Add notes about pre-stabilization to contributor unstable docs #10675
New issue
Have a question about this project? # for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “#”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? # to your account
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nitpick: Could we use link references instead of inline links for source code readability?
Yep! I'll make that change! |
02cfe9d
to
5418d58
Compare
It looks like this failed for network connectivity issues. Can someone rerun this for me? |
([rust subreddit], [users], [internals], etc). Example posts made for workspace | ||
inheritance: [reddit post], [users post], [internals post]. The unstable feature | ||
should also be added to [This Week in Rust]. This should be done by adding the | ||
label `call-for-testing` to the RFC for the feature and making a comment with a |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Is this label a thing now? Someone already created it in rust-lang/rfcs, but the discussion of its mechanism seems not yet finished as far as I see.
Apart from that, the write-up looks good to me :)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
From what I can gather (and have commented on) it is fairly set in stone that the call-for-testing
label will be used to denote what should be added to the Call for Testing
section. How exactly that label gets added or removed or for how long it will be in TWiR is up in the air. I think that this is a "until we find a better solution" change, which that solution may take a bit of time. I am okay with this being open until everything gets finalized but I think having something is better than nothing. That something could be everything except the stuff for TWiR while it gets completely settled, but I don't know if that is needed.
That being said, I could ask if they would also check rust-lang/cargo
for the call-for-testing
label if someone can create it here.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Fair enough. Thanks for the clarification! I am going to merge this, and we can always tweak it afterwards.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The issue that was tracking how call-for-testing
should work, got closed so it's a bit more set in stone. I'll keep and eye on any future updates of it and update the docs as needed. Thanks for merging this!
@bors r+ |
📌 Commit 5418d58 has been approved by |
☀️ Test successful - checks-actions |
Update cargo 3 commits in 3f052d8eed98c6a24f8b332fb2e6e6249d12d8c1..a4c1cd0eb6b18082a7e693f5a665548fe1534be4 2022-05-12 15:19:04 +0000 to 2022-05-18 01:52:07 +0000 - Add notes about pre-stabilization to contributor unstable docs (rust-lang/cargo#10675) - reference: Update syntax supported by `rustc-link-lib` (rust-lang/cargo#10674) - Correct the release dates for 1.61 and 1.62 (rust-lang/cargo#10665)
Update cargo 3 commits in 3f052d8eed98c6a24f8b332fb2e6e6249d12d8c1..a4c1cd0eb6b18082a7e693f5a665548fe1534be4 2022-05-12 15:19:04 +0000 to 2022-05-18 01:52:07 +0000 - Add notes about pre-stabilization to contributor unstable docs (rust-lang/cargo#10675) - reference: Update syntax supported by `rustc-link-lib` (rust-lang/cargo#10674) - Correct the release dates for 1.61 and 1.62 (rust-lang/cargo#10665)
This PR is meant to add more direction for contributors on the path to stabilization for unstable features. It adds a section titled
Pre-Stabilization
to the unstable contributor docs.The idea for this came out of the discussion about when and how to stabilize workspace inheritance. The notes that are being added were derived from the above comment as well as the the adding of the
Call for Testing
section to TWiR. This comment gives more information as well.As for the requirement of testing notes, there is still discussion about if they are needed.
While what was added is not comprehensive it is meant as a guide for what to do as each feature has different requirements for stabilization
r? @epage