|
| 1 | +# Package Manager Feature name |
| 2 | + |
| 3 | +* Proposal: [SE-NNNN](NNNN-filename.md) |
| 4 | +* Authors: [Author 1](https://github.com/swiftdev), [Author 2](https://github.com/swiftdev) |
| 5 | +* Review Manager: TBD |
| 6 | +* Status: **Awaiting implementation** |
| 7 | + |
| 8 | +*During the review process, add the following fields as needed:* |
| 9 | + |
| 10 | +* Implementation: [apple/swift-package-manager#NNNNN](https://github.com/apple/swift-package-manager/pull/NNNNN) |
| 11 | +* Decision Notes: [Rationale](https://forums.swift.org/), [Additional Commentary](https://forums.swift.org/) |
| 12 | +* Bugs: [SR-NNNN](https://bugs.swift.org/browse/SR-NNNN), [SR-MMMM](https://bugs.swift.org/browse/SR-MMMM) |
| 13 | +* Previous Revision: [1](https://github.com/apple/swift-evolution/blob/...commit-ID.../proposals/NNNN-filename.md) |
| 14 | +* Previous Proposal: [SE-XXXX](XXXX-filename.md) |
| 15 | + |
| 16 | +## Introduction |
| 17 | + |
| 18 | +A short description of what the feature is. Try to keep it to a single-paragraph |
| 19 | +"elevator pitch" so the reader understands what problem this proposal is |
| 20 | +addressing. |
| 21 | + |
| 22 | +Swift-evolution thread: [Discussion thread topic for that |
| 23 | +proposal](https://forums.swift.org/) |
| 24 | + |
| 25 | +## Motivation |
| 26 | + |
| 27 | +Describe the problems that this proposal seeks to address. If the problem is |
| 28 | +that some functionality is currently hard to use, show how it is currently used |
| 29 | +and describe its drawbacks. If it's completely new functionality that cannot be |
| 30 | +emulated, motivate why this new functionality would help Swift developers create |
| 31 | +better Swift packages. |
| 32 | + |
| 33 | +## Proposed solution |
| 34 | + |
| 35 | +Describe your solution to the problem. Provide examples and describe how they |
| 36 | +work. Show how your solution is better than current workarounds: is it cleaner, |
| 37 | +easier, or more efficient? |
| 38 | + |
| 39 | +## Detailed design |
| 40 | + |
| 41 | +Describe the design of the solution in detail. If it involves adding or |
| 42 | +modifying functionality in the package manager, explain how the package manager |
| 43 | +behaves in different scenarios and with existing features. If it's a new API in |
| 44 | +the `Package.swift` manifest, show the full API and its documentation comments |
| 45 | +detailing what it does. The detail in this section should be sufficient for |
| 46 | +someone who is *not* one of the author of the proposal to be able to reasonably |
| 47 | +implement the feature. |
| 48 | + |
| 49 | +## Security |
| 50 | + |
| 51 | +Does this change have any impact on security, safety, or privacy? |
| 52 | + |
| 53 | +## Impact on exisiting packages |
| 54 | + |
| 55 | +Explain if and how this proposal will affect the behavior of existing packages. |
| 56 | +If there will be impact, is it possible to gate the changes on the tools version |
| 57 | +of the package manifest? |
| 58 | + |
| 59 | +## Alternatives considered |
| 60 | + |
| 61 | +Describe alternative approaches to addressing the same problem, and |
| 62 | +why you chose this approach instead. |
0 commit comments