Skip to content

Commit b6b2cac

Browse files
chore: CONTRIBUTION.md update
1 parent eebd43d commit b6b2cac

File tree

1 file changed

+20
-15
lines changed

1 file changed

+20
-15
lines changed

CONTRIBUTION.md

+20-15
Original file line numberDiff line numberDiff line change
@@ -6,19 +6,20 @@ So in the `1.0.0` version, each position means the following:
66
- \*.1.***minor release**. Added one or more new features to the lib and no breaking changes were introduced. Everything will work as expected, no changes are required in your projects;
77
- \*.*.1 — **patch release**. Fixed one or more bugs, performed code refactoring, updated documentation or did something with the existing code base that doesn’t include new features nor breaks current ones.
88

9-
Though, this library is living within the **three weeks minor release** schedule, please keep in mind that for the sake of avoiding complex merge conflicts, we’re currently taking only **one big feature** per release, so if you want to take some, please drop us a message somewhere to avoiding reworking it after it’ll be broken by some massive merge.
9+
Though, this library is living within the **three weeks minor release** schedule, please keep in mind that for the sake of avoiding complex merge conflicts, we’re currently taking only **one big feature** per release, so if you want to take some, please drop us a message somewhere (e.g. in [Discord](https://discord.com/invite/8bHCNmhS7x) in #contributors channel) to avoiding reworking it after it’ll be broken by some massive merge and to plan it correctly before you start.
1010

1111
Critical bug fixes must be marked with the appropriate label in PR and should be processed **within one week** (at least we’ll try our best to make that).
1212

13-
## What task to choose
13+
## Choosing a task
1414
Please take it from the [roadmap](https://hackmd.io/G5znP3xAQY-BVc1X8Y1jSg) or from the [opened issues](https://github.com/skywinder/web3swift/issues?q=is:issue+is:open+sort:updated-desc "").
1515

16-
> If you want to make something completely new and purely magical, please drop us a message somewhere before, since it could ends up that this is what we planning to do a lot later or that we not planning at all.
16+
> If you want to make something completely new and purely magical, please drop us a message somewhere before you start (e.g. in [Discord](https://discord.com/invite/8bHCNmhS7x) in #contributors channel). Some features could be already planned but for a later stages or not planned (purposefuly not willing to include) at all.
1717
1818
## Codestyle guideline
1919
- `swiftlint` check should goes with no warnings.
20-
- Here’s some more detailed and human readable code style [guidelines](https://hackmd.io/8bACoAnTSsKc55Os596yCg "") (you can add there some suggestion if you’d like to).
21-
- We use [swift](https://www.swift.org/documentation/api-design-guidelines/ "") name convention.
20+
- Here’s some more detailed and human readable code style [guidelines](https://hackmd.io/8bACoAnTSsKc55Os596yCg) (you can add there some suggestion if you’d like to).
21+
- We use [swift](https://www.swift.org/documentation/api-design-guidelines/) name convention.
22+
2223
## Tests guideline
2324
1. Cover each new public method with tests.
2425
2. If you’re implementing some big feature encapsulate it in Separate file.
@@ -31,12 +32,16 @@ Please take it from the [roadmap](https://hackmd.io/G5znP3xAQY-BVc1X8Y1jSg) or f
3132
## Hacks & tricks & magic
3233
### TestPlans
3334
In ci/cd we’re using Xcode test plans feature to spread tests to local and remote one. So any time you’re adding any new test suit (file) please exclude it from `LocalTests.xctestplan` rather `RemoteTests.xctestplan` depends on what tests group it included.
35+
3436
### Swift package manager
3537
Please add any files unused due build process to `excludeFiles` array in `Package.swift`.
38+
3639
### Carthage
3740
Please do not forget to add & remove all new or dropped files and dependencies in carthage `.xcodeproj` file if you’re working with project anywhere but carthage project.
41+
3842
### Cocoapods
3943
Please do not forget to add & remove all dependencies within `web3swift.podspec` file.
44+
4045
### GitHub actions
4146
You’re able to use our github actions checks in your fork without needing to make PR to this repo. To get that just add your branch name to the branch list in file on path `.github/actions/ci.yml` to let the magic happening like follow:
4247

@@ -54,17 +59,17 @@ on:
5459
5560
## Good PR checklist
5661
### Code
57-
- [ ] All new functionality covered by unit tests.
58-
- [ ] Ci/cd green.
59-
- [ ] No redundant files are added (build cache, Xcode breakpoints settings and so on).
62+
- [ ] All new functionality is covered by unit tests;
63+
- [ ] All changes are focused on something specific, e.g. 1 feature 1 PR, 1 file refactored in 1 PR (depends on how much was refactored, etc.);
64+
- [ ] No redundant files are added (build cache, Xcode breakpoints settings and so on);
65+
- [ ] Documentation is added or updated. Refactoring a function with no documentation - add documentation. Fixing a bug - updated documentation to reflect changes correctly.
6066

6167
### Info
62-
- [ ] Relative and concrete PR title.
63-
- [ ] Issue or roadmap goal attached.
64-
- [ ] PR description filled with detail explanation of what it is and what’s its specific.
68+
- [ ] Short and understandable PR title;
69+
- [ ] Issue or roadmap goal is attached if applicable;
70+
- [ ] PR description filled with detailed explanation of what was changed and reasons for the changes made.
6571

6672
### Codestyle
67-
- [ ] All public method have `///` styled comments.
68-
- [ ] All magic or nonintuitive internal code parts are clearly explained in inline comments.
69-
- [ ] `swiftlint` ran have no warnings.
70-
- [ ] No commented out code lefts in PR.
73+
- [ ] All public method have `///` styled comments;
74+
- [ ] All magic or nonintuitive internal code parts are clearly explained with additional in inline comments;
75+
- [ ] No commented out code is left in a PR.

0 commit comments

Comments
 (0)