Skip to content

Commit 2ab32da

Browse files
XAMPPRockygavofyork
authored andcommitted
Move documentation from Asciidoc to Markdown. (paritytech#619)
1 parent ead2346 commit 2ab32da

11 files changed

+180
-157
lines changed
+11-12
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
1-
= Contributor Covenant Code of Conduct
1+
# Contributor Covenant Code of Conduct
22

3-
== Our Pledge
3+
## Our Pledge
44

55
In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.
66

7-
== Our Standards
7+
## Our Standards
88

99
Examples of behavior that contributes to creating a positive environment include:
1010

@@ -22,32 +22,31 @@ Examples of unacceptable behavior by participants include:
2222
* Publishing others' private information, such as a physical or electronic address, without explicit permission
2323
* Other conduct which could reasonably be considered inappropriate in a professional setting
2424

25-
=== Facilitation, Not Strongarming
25+
### Facilitation, Not Strongarming
2626

2727
We recognise that this software is merely a tool for users to create and maintain their blockchain of preference. We see that blockchains are naturally community platforms with users being the ultimate decision makers. We assert that good software will maximise user agency by facilitate user-expression on the network. As such:
2828

2929
* This project will strive to give users as much choice as is both reasonable and possible over what protocol they adhere to; but
3030
* use of the project's technical forums, commenting systems, pull requests and issue trackers as a means to express individual protocol preferences is forbidden.
3131

32-
== Our Responsibilities
32+
## Our Responsibilities
3333

3434
Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
3535

3636
Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.
3737

38-
== Scope
38+
## Scope
3939

4040
This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.
4141

42-
== Enforcement
42+
## Enforcement
4343

44-
Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at admin@parity.io. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
44+
Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at <admin@parity.io>. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
4545

4646
Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.
4747

48-
== Attribution
48+
## Attribution
4949

50-
This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version]
50+
This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at https://contributor-covenant.org/version/1/4
5151

52-
[homepage]: http://contributor-covenant.org
53-
[version]: http://contributor-covenant.org/version/1/4/
52+
[homepage]: https://contributor-covenant.org

CONTRIBUTING.adoc CONTRIBUTING.md

+28-26
Original file line numberDiff line numberDiff line change
@@ -1,50 +1,52 @@
1-
= Contributing
1+
# Contributing
22

33
`Substrate` projects is a **OPENISH Open Source Project**
44

5-
== What?
5+
## What?
66

77
Individuals making significant and valuable contributions are given commit-access to a project to contribute as they see fit. A project is more like an open wiki than a standard guarded open source project.
88

9-
== Rules
9+
## Rules
1010

1111
There are a few basic ground-rules for contributors (including the maintainer(s) of the project):
1212

13-
. **No `--force` pushes** or modifying the Git history in any way. If you need to rebase, ensure you do it in your own repo.
14-
. **Non-master branches**, prefixed with a short name moniker (e.g. `gav-my-feature`) must be used for ongoing work.
15-
. **All modifications** must be made in a **pull-request** to solicit feedback from other contributors.
16-
. A pull-request *must not be merged until CI* has finished successfully.
17-
. Contributors should adhere to the https://github.com/paritytech/polkadot/wiki/Style-Guide[house coding style].
13+
- **No `--force` pushes** or modifying the Git history in any way. If you need to rebase, ensure you do it in your own repo.
14+
- **Non-master branches**, prefixed with a short name moniker (e.g. `gav-my-feature`) must be used for ongoing work.
15+
- **All modifications** must be made in a **pull-request** to solicit feedback from other contributors.
16+
- A pull-request _must not be merged until CI_ has finished successfully.
17+
- Contributors should adhere to the https://github.com/paritytech/polkadot/wiki/Style-Guide[house coding style].
1818

19-
Merging pull requests once CI is successful:
19+
#### Merging pull requests once CI is successful:
2020

21-
. A pull request that does not alter any logic (e.g. comments, dependencies, docs) may be tagged https://github.com/paritytech/substrate/pulls?utf8=%E2%9C%93&q=is%3Apr+is%3Aopen+label%3AA2-insubstantial[`insubstantial`] and merged by its author.
22-
. A pull request with no large change to logic that is an urgent fix may be merged after a non-author contributor has reviewed it well.
23-
. All other PRs should sit for 48 hours with the https://github.com/paritytech/substrate/pulls?q=is%3Apr+is%3Aopen+label%3AA0-pleasereview[`pleasereview`] tag in order to garner feedback.
24-
. No PR should be merged until all reviews' comments are addressed.
21+
- A pull request that does not alter any logic (e.g. comments, dependencies, docs) may be tagged https://github.com/paritytech/substrate/pulls?utf8=%E2%9C%93&q=is%3Apr+is%3Aopen+label%3AA2-insubstantial[`insubstantial`] and merged by its author.
22+
- A pull request with no large change to logic that is an urgent fix may be merged after a non-author contributor has reviewed it well.
23+
- All other PRs should sit for 48 hours with the https://github.com/paritytech/substrate/pulls?q=is%3Apr+is%3Aopen+label%3AA0-pleasereview[`pleasereview`] tag in order to garner feedback.
24+
- No PR should be merged until all reviews' comments are addressed.
25+
26+
#### Reviewing pull requests:
2527

26-
.Reviewing pull requests:
2728
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:
2829

29-
. Buggy behaviour.
30-
. Undue maintenance burden.
31-
. Breaking with house coding style.
32-
. Pessimisation (i.e. reduction of speed as measured in the projects benchmarks).
33-
. Feature reduction (i.e. it removes some aspect of functionality that a significant minority of users rely on).
34-
. Uselessness (i.e. it does not strictly add a feature or fix a known issue).
30+
- Buggy behaviour.
31+
- Undue maintenance burden.
32+
- Breaking with house coding style.
33+
- Pessimisation (i.e. reduction of speed as measured in the projects benchmarks).
34+
- Feature reduction (i.e. it removes some aspect of functionality that a significant minority of users rely on).
35+
- Uselessness (i.e. it does not strictly add a feature or fix a known issue).
36+
37+
#### Reviews may not be used as an effective veto for a PR because:
3538

36-
.Reviews may not be used as an effective veto for a PR because:
37-
. There exists a somewhat cleaner/better/faster way of accomplishing the same feature/fix.
38-
. It does not fit well with some other contributors' longer-term vision for the project.
39+
- There exists a somewhat cleaner/better/faster way of accomplishing the same feature/fix.
40+
- It does not fit well with some other contributors' longer-term vision for the project.
3941

40-
== Releases
42+
## Releases
4143

4244
Declaring formal releases remains the prerogative of the project maintainer(s).
4345

44-
== Changes to this arrangement
46+
## Changes to this arrangement
4547

4648
This is an experiment and feedback is welcome! This document may also be subject to pull-requests or changes by contributors where you believe you have something valuable to add or change.
4749

48-
== Heritage
50+
## Heritage
4951

5052
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

0 commit comments

Comments
 (0)