Newer
Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
Substrate Sidecar API is an open source project that welcomes new issues and
PRs.
If you’re new to open source or interested in contributing, this guide is
particularly helpful:
[How to Contribute to Open Source](https://opensource.guide/how-to-contribute/).
## Contributing Code
To contribute to this repo, start by creating a GitHub Issue, which will allow
you to gather feedback before writing any code. In the Issues tab, you’ll be
able to select from a template to create an Issue.
To create a Pull Request after you’ve created an Issue, you’ll need to head over
to the Pull Request tab. This will be where all the PRs will be located, and
where reviewers will be able to review your changes made.
## Rules
There are a few basic ground-rules for contributors (including the maintainer(s)
of the project):
- Try to avoid `--force` pushes or modifying the Git history in any way. If you
need to rebase, ensure you do it in your own repo.
- Non-master branches, prefixed with a short name moniker (e.g.
`gav-my-feature`), must be used for ongoing work.
- All modifications must be made in a Pull Request to solicit feedback from
other contributors.
- Contributors should adhere to the
[house coding style](https://github.com/paritytech/substrate/blob/master/docs/STYLE_GUIDE.md).
## Reviewing Pull Requests:
When reviewing a Pull Request, the end goal is to suggest useful changes to the
author. Reviews should finish with approval unless there are issues that would
result in:
- Buggy behaviour.
- Undue maintenance burden.
- Breaking with house coding style.
- Poor performance.
- Feature reduction (i.e. it removes some aspect of functionality that a
significant minority of users rely on).
- Uselessness (i.e. it does not strictly add a feature or fix a known issue).
## Where to Ask for Help
Asking for help in the Parity community is encouraged and welcomed! The best
ways to reach us are:
- Chat with us:
[Substrate Technical Element](https://app.element.io/#/room/!HzySYSaIhtyWrwiwEV:matrix.org)
- Ask a question tagged `substrate`:
[Stack Overflow](https://stackoverflow.com/questions/tagged/substrate)
- Weekly office hours: [Substrate Seminar](https://substrate.dev/en/seminar)
## Heritage
These contributing guidelines are modified from the "OPEN Open Source Project"
guidelines for the Level project:
https://github.com/Level/community/blob/master/CONTRIBUTING.md