|
| 1 | +# Implement Open API Namespace Support |
| 2 | + |
| 3 | + |
| 4 | +| Metadata | | |
| 5 | +| -------- | ------------------------------------------------------------ | |
| 6 | +| Owner(s) | ![Help wanted][] | |
| 7 | +| Teams | [cargo], [compiler], [crates-io] | |
| 8 | +| Status | Proposed | |
| 9 | + |
| 10 | +## Summary |
| 11 | + |
| 12 | +Navigate the cross-team design work to get [RFC 3243](https://github.com/rust-lang/rfcs/pull/3243) implemented. |
| 13 | + |
| 14 | +## Motivation |
| 15 | + |
| 16 | +[RFC 3243](https://github.com/rust-lang/rfcs/pull/3243) proposed opening up namespaces in Rust to extension, |
| 17 | +managed by the package name with crates-io putting access control on who can publish to a crate's API namespace. |
| 18 | +This covers multiple teams and needs a lot of coordination to balance the needs of each team as shown on the [rustc tracking issue](https://github.com/rust-lang/rust/issues/122349). |
| 19 | + |
| 20 | +### The status quo |
| 21 | + |
| 22 | +Cargo support is partially implemented. |
| 23 | +No compiler support. |
| 24 | +There is a crates-io prototype for a previous iteration of RFC 3243 but that code base has likely diverged a lot since then. |
| 25 | + |
| 26 | +### The next 6 months |
| 27 | + |
| 28 | +Implement at least Cargo and compiler support for this to be experimented with and allow crates-io work. |
| 29 | + |
| 30 | +### The "shiny future" we are working towards |
| 31 | + |
| 32 | +## Design axioms |
| 33 | + |
| 34 | +## Ownership and team asks |
| 35 | + |
| 36 | +| Subgoal | Owner(s) or team(s) | Notes | |
| 37 | +| ---------------------------------------------- | ----------------------- | ----- | |
| 38 | +| Discussion and moral support | ![Team][] [cargo], [compiler] | | |
| 39 | +| Compiler implementation | ![Help wanted][] | | |
| 40 | +| Work through lingering cargo issues | Goal owner, @epage | | |
| 41 | + |
| 42 | +### Definitions |
| 43 | + |
| 44 | +Definitions for terms used above: |
| 45 | + |
| 46 | +* *Discussion and moral support* is the lowest level offering, basically committing the team to nothing but good vibes and general support for this endeavor. |
| 47 | +* *Author RFC* and *Implementation* means actually writing the code, document, whatever. |
| 48 | +* *Design meeting* means holding a synchronous meeting to review a proposal and provide feedback (no decision expected). |
| 49 | +* *RFC decisions* means reviewing an RFC and deciding whether to accept. |
| 50 | +* *Org decisions* means reaching a decision on an organizational or policy matter. |
| 51 | +* *Secondary review* of an RFC means that the team is "tangentially" involved in the RFC and should be expected to briefly review. |
| 52 | +* *Stabilizations* means reviewing a stabilization and report and deciding whether to stabilize. |
| 53 | +* *Standard reviews* refers to reviews for PRs against the repository; these PRs are not expected to be unduly large or complicated. |
| 54 | +* *Prioritized nominations* refers to prioritized lang-team response to nominated issues, with the expectation that there will be *some* response from the next weekly triage meeting. |
| 55 | +* *Dedicated review* means identifying an individual (or group of individuals) who will review the changes, as they're expected to require significant context. |
| 56 | +* Other kinds of decisions: |
| 57 | + * [Lang team experiments](https://lang-team.rust-lang.org/how_to/experiment.html) are used to add nightly features that do not yet have an RFC. They are limited to trusted contributors and are used to resolve design details such that an RFC can be written. |
| 58 | + * Compiler [Major Change Proposal (MCP)](https://forge.rust-lang.org/compiler/mcp.html) is used to propose a 'larger than average' change and get feedback from the compiler team. |
| 59 | + * Library [API Change Proposal (ACP)](https://std-dev-guide.rust-lang.org/development/feature-lifecycle.html) describes a change to the standard library. |
| 60 | + |
| 61 | +## Frequently asked questions |
0 commit comments