Skip to content

Document the new ACP process #40

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

Merged
merged 2 commits into from
Jun 6, 2022
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Next Next commit
Document the new ACP process
  • Loading branch information
yaahc committed Jun 6, 2022
commit a5c72a2c65b45b332047ec4074db89416b0706b3
2 changes: 1 addition & 1 deletion src/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@
---

- [The feature lifecycle](./feature-lifecycle/summary.md)
- [Landing new features](./feature-lifecycle/new-unstable-features.md)
- [API Change Proposals](./feature-lifecycle/api-change-proposals.md)
- [Using tracking issues](./feature-lifecycle/tracking-issues.md)
- [Stabilizing features](./feature-lifecycle/stabilization.md)
- [Deprecating features](./feature-lifecycle/deprecation.md)
Expand Down
21 changes: 21 additions & 0 deletions src/feature-lifecycle/api-change-proposals.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
# API Change Proposals (ACP)

Changes to the standard library's unstable API go through the libs ACP process.

The API Change Proposal process is intended to be a lightweight first step to
getting new APIs added to the standard library. The goal of this process is to
make sure proposed API changes have the best chance of success. The ACP process
accomplishes this by ensuring all changes have had a libs-api team member
second the proposal indicating that they are optimistic that the proposal will
pass its eventual FCP and by focusing the initial discussion on the problems
being solved and concrete motivating examples.

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).

Once a t-libs-api team member has reviewed the ACP and judged that it should
move forward they will second the ACP (via `@rfcbot second`) and initiate an
ICP (inital comment period). This initial comment period is intended to give
other stake holders a chance to participate in the initial discussion prior to
starting the implementation. Once this ICP has completed you should proceed
with the implementation of your proposal and then move on to the next step of
the feature lifecycle, creating a tracking issue.