2020-12-04 11:10:55 +00:00
|
|
|
---
|
|
|
|
name: Library Tracking Issue
|
|
|
|
about: A tracking issue for an unstable library feature.
|
|
|
|
title: Tracking Issue for XXX
|
2021-06-18 16:44:09 +00:00
|
|
|
labels: C-tracking-issue, T-libs-api
|
2020-12-04 11:10:55 +00:00
|
|
|
---
|
|
|
|
<!--
|
|
|
|
Thank you for creating a tracking issue!
|
|
|
|
|
|
|
|
Tracking issues are for tracking a feature from implementation to stabilization.
|
|
|
|
|
|
|
|
Make sure to include the relevant RFC for the feature if it has one.
|
|
|
|
|
|
|
|
If the new feature is small, it may be fine to skip the RFC process. In that
|
2023-04-09 23:18:15 +00:00
|
|
|
case, you can use `issue = "none"` in your initial implementation PR. The
|
2020-12-04 11:10:55 +00:00
|
|
|
reviewer will ask you to open a tracking issue if they agree your feature can be
|
|
|
|
added without an RFC.
|
|
|
|
-->
|
|
|
|
|
|
|
|
Feature gate: `#![feature(...)]`
|
|
|
|
|
|
|
|
This is a tracking issue for ...
|
|
|
|
|
|
|
|
<!--
|
|
|
|
Include a short description of the feature.
|
|
|
|
-->
|
|
|
|
|
|
|
|
### Public API
|
|
|
|
|
|
|
|
<!--
|
|
|
|
For most library features, it'd be useful to include a summarized version of the public API.
|
|
|
|
(E.g. just the public function signatures without their doc comments or implementation.)
|
|
|
|
-->
|
|
|
|
|
|
|
|
```rust
|
2020-12-31 12:52:39 +00:00
|
|
|
// core::magic
|
|
|
|
|
|
|
|
pub struct Magic;
|
|
|
|
|
|
|
|
impl Magic {
|
|
|
|
pub fn magic(self);
|
|
|
|
}
|
2020-12-04 11:10:55 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
### Steps / History
|
|
|
|
|
|
|
|
<!--
|
2020-12-31 12:52:39 +00:00
|
|
|
For larger features, more steps might be involved.
|
|
|
|
If the feature is changed later, please add those PRs here as well.
|
2020-12-04 11:10:55 +00:00
|
|
|
-->
|
|
|
|
|
2020-12-31 12:52:39 +00:00
|
|
|
- [ ] Implementation: #...
|
2022-03-11 00:59:08 +00:00
|
|
|
- [ ] Final comment period (FCP)[^1]
|
2020-12-04 11:10:55 +00:00
|
|
|
- [ ] Stabilization PR
|
|
|
|
|
2020-12-31 12:52:39 +00:00
|
|
|
<!--
|
|
|
|
Once the feature has gone through a few release cycles and there are no
|
|
|
|
unresolved questions left, the feature might be ready for stabilization.
|
|
|
|
|
2021-06-28 06:00:26 +00:00
|
|
|
If this feature didn't go through the RFC process, a final comment period
|
2020-12-31 12:52:39 +00:00
|
|
|
(FCP) is always needed before stabilization. This works as follows:
|
|
|
|
|
2021-06-18 16:44:09 +00:00
|
|
|
A library API team member can kick off the stabilization process, at which point
|
2020-12-31 12:52:39 +00:00
|
|
|
the rfcbot will ask all the team members to verify they agree with
|
|
|
|
stabilization. Once enough members agree and there are no concerns, the final
|
2021-06-28 06:00:26 +00:00
|
|
|
comment period begins: this issue will be marked as such and will be listed
|
2020-12-31 12:52:39 +00:00
|
|
|
in the next This Week in Rust newsletter. If no blocking concerns are raised in
|
2023-04-09 23:18:15 +00:00
|
|
|
that period of 10 days, a stabilization PR can be opened by anyone.
|
2020-12-31 12:52:39 +00:00
|
|
|
-->
|
|
|
|
|
2020-12-04 11:10:55 +00:00
|
|
|
### Unresolved Questions
|
|
|
|
|
|
|
|
<!--
|
|
|
|
Include any open questions that need to be answered before the feature can be
|
|
|
|
stabilised. If multiple (unrelated) big questions come up, it can be a good idea
|
|
|
|
to open a separate issue for each, to make it easier to keep track of the
|
|
|
|
discussions.
|
|
|
|
|
|
|
|
It's useful to link any relevant discussions and conclusions (whether on GitHub,
|
|
|
|
Zulip, or the internals forum) here.
|
|
|
|
-->
|
|
|
|
|
|
|
|
- None yet.
|
2022-03-11 00:59:08 +00:00
|
|
|
|
|
|
|
[^1]: https://std-dev-guide.rust-lang.org/feature-lifecycle/stabilization.html
|