Skip to content

Commit a5c72a2

Browse files
committed
Document the new ACP process
1 parent 0cb9115 commit a5c72a2

File tree

2 files changed

+22
-1
lines changed

2 files changed

+22
-1
lines changed

src/SUMMARY.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@
1717
---
1818

1919
- [The feature lifecycle](./feature-lifecycle/summary.md)
20-
- [Landing new features](./feature-lifecycle/new-unstable-features.md)
20+
- [API Change Proposals](./feature-lifecycle/api-change-proposals.md)
2121
- [Using tracking issues](./feature-lifecycle/tracking-issues.md)
2222
- [Stabilizing features](./feature-lifecycle/stabilization.md)
2323
- [Deprecating features](./feature-lifecycle/deprecation.md)
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
# API Change Proposals (ACP)
2+
3+
Changes to the standard library's unstable API go through the libs ACP process.
4+
5+
The API Change Proposal process is intended to be a lightweight first step to
6+
getting new APIs added to the standard library. The goal of this process is to
7+
make sure proposed API changes have the best chance of success. The ACP process
8+
accomplishes this by ensuring all changes have had a libs-api team member
9+
second the proposal indicating that they are optimistic that the proposal will
10+
pass its eventual FCP and by focusing the initial discussion on the problems
11+
being solved and concrete motivating examples.
12+
13+
You can create an ACP in the `rust-lang/libs-team` repo using [this issue template](https://github.com/rust-lang/libs-team/issues/new?assignees=&labels=api-change-proposal%2C+T-libs-api&template=api-change-proposal.md&title=%28My+API+Change+Proposal%29).
14+
15+
Once a t-libs-api team member has reviewed the ACP and judged that it should
16+
move forward they will second the ACP (via `@rfcbot second`) and initiate an
17+
ICP (inital comment period). This initial comment period is intended to give
18+
other stake holders a chance to participate in the initial discussion prior to
19+
starting the implementation. Once this ICP has completed you should proceed
20+
with the implementation of your proposal and then move on to the next step of
21+
the feature lifecycle, creating a tracking issue.

0 commit comments

Comments
 (0)