You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+30-27Lines changed: 30 additions & 27 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,9 +4,9 @@ Contributions to Swift are welcomed and encouraged!
4
4
For contributions to the broader Swift Language project, please see the
5
5
[Contributing to Swift guide](https://swift.org/contributing/).
6
6
7
-
To give clarity of what is expected of our members, Swift has adopted the code of conduct defined by the Contributor Covenant.
8
-
This document is used across many open source communities, and we think it articulates our values well.
9
-
For more detail, see the [Code of Conduct](https://swift.org/code-of-conduct/).
7
+
To give clarity of what is expected of our members, Swift has adopted the code of conduct defined by the [Contributor Covenant](http://contributor-covenant.org/).
8
+
This document is used across many open source communities, and it articulates our values.
9
+
For more detail, read the project's[Code of Conduct](https://swift.org/code-of-conduct/).
10
10
11
11
It is highly recommended that you become familiar with using Swift in your own projects before contributing directly to the language itself.
12
12
We put together handy [Getting Started](https://www.swift.org/getting-started/) guide and tutorials with step-by-step instructions to get you up and running.
@@ -34,13 +34,6 @@ Include information about the Swift compiler’s version, the deployment target
34
34
Because Swift is under very active development, we receive a lot of bug reports.
35
35
Before opening a new issue, take a moment to [browse our existing issues](https://github.com/swiftlang/swift/issues) to reduce the chance of reporting a duplicate.
36
36
37
-
## Proposing changes - Swift Evolution
38
-
39
-
Shaping the future of Swift is a community effort that anyone can participate in via the [Evolution sections on the Swift forums](https://www.swift.org/community/#swift-evolution).
40
-
The [Swift evolution process](https://github.com/swiftlang/swift-evolution/blob/main/process.md) covers all changes to the Swift language and the public interface of the Swift standard library, including new language features and APIs, changes to existing language features or APIs, removal of existing features, and so on.
41
-
42
-
See the [Swift evolution review schedule](https://www.swift.org/swift-evolution) for current and upcoming proposal reviews.
43
-
44
37
## Good First Issues
45
38
46
39
Good first issues are bugs, ideas, and tasks that are intended to be accessible for contributors that are new to working on the Swift project, and even new to the patterns and concepts behind subprojects such as the Swift compiler.
@@ -53,6 +46,7 @@ Anyone with [commit access](https://www.swift.org/contributing/#commit-access) a
53
46
## Contributing Code
54
47
55
48
If you are interested in:
49
+
56
50
- Contributing fixes and features to the compiler: See our
57
51
[How to Submit Your First Pull Request guide](/docs/HowToGuides/FirstPullRequest.md).
58
52
- Building the compiler as a one-off: See our [Getting Started guide][].
@@ -64,6 +58,13 @@ We also host answers to [Frequently Aasked Questions](/docs/HowToGuides/FAQ.md)
64
58
65
59
[Getting Started guide]: /docs/HowToGuides/GettingStarted.md
66
60
61
+
### Proposing changes - Swift Evolution
62
+
63
+
Shaping the future of Swift is a community effort that anyone can participate in via the [Evolution sections on the Swift forums](https://www.swift.org/community/#swift-evolution).
64
+
The [Swift evolution process](https://github.com/swiftlang/swift-evolution/blob/main/process.md) covers all changes to the Swift language and the public interface of the Swift standard library, including new language features and APIs, changes to existing language features or APIs, removal of existing features, and so on.
65
+
66
+
See the [Swift evolution review schedule](https://www.swift.org/swift-evolution) for current and upcoming proposal reviews.
67
+
67
68
### Incremental Development
68
69
69
70
The Swift project uses small, incremental changes as its preferred development model.
@@ -176,23 +177,6 @@ The divider lines should be exactly 80 characters wide to aid in adherence to th
176
177
The bottom section contains an optional description intended for generated documentation (these lines begin with `///` rather than `//`).
177
178
If there is no description, this area can be skipped.
178
179
179
-
### Release Branch Pull Requests
180
-
181
-
A pull request targeting a release branch (`release/x.y` or `swift/release/x.y`) cannot be merged without a GitHub approval by a corresponding branch manager.
182
-
In order for a change to be considered for inclusion in a release branch, the pull request must have:
183
-
184
-
A title starting with a designation containing the release version number of the target branch.
185
-
186
-
[This form](https://github.com/swiftlang/.github/blob/main/PULL_REQUEST_TEMPLATE/release.md?plain=1) filled out in its description.
187
-
An item that is not applicable may be left blank or completed with an indication thereof, but must not be omitted altogether.
188
-
189
-
To switch to this template when drafting a pull request in a [swiftlang](https://github.com/swiftlang) repository in a browser, append the `template=release.md` query parameter to the current URL and refresh. For example:
[Here](https://github.com/swiftlang/swift/pull/73697) is an example.
195
-
196
180
### Code Review
197
181
198
182
The Swift project relies heavily on code review to improve software quality:
@@ -257,6 +241,25 @@ You are expected to check those messages to see whether they are your fault and,
257
241
Commits that clearly violate these quality standards may be reverted, in particular when the change blocks other developers from making progress.
258
242
The developer is welcome to recommit the change after the problem has been fixed.
259
243
244
+
### Release Branch Pull Requests
245
+
246
+
A pull request targeting a release branch (`release/x.y` or `swift/release/x.y`) cannot be merged without a GitHub approval by a corresponding branch manager.
247
+
In order for a change to be considered for inclusion in a release branch, the pull request must have:
248
+
249
+
A title starting with a designation containing the release version number of the target branch.
250
+
251
+
[This form](https://github.com/swiftlang/.github/blob/main/PULL_REQUEST_TEMPLATE/release.md?plain=1) filled out in its description.
252
+
An item that is not applicable may be left blank or completed with an indication thereof, but must not be omitted altogether.
253
+
254
+
To switch to this template when drafting a pull request in a [swiftlang](https://github.com/swiftlang) repository in a browser, append the `template=release.md` query parameter to the current URL and refresh. For example:
0 commit comments