mirror of https://github.com/vacp2p/rfc.git
Add contributing file with lifecycle
This commit is contained in:
parent
3d3f323438
commit
cc8a60467a
|
@ -0,0 +1,39 @@
|
||||||
|
# Contributing
|
||||||
|
|
||||||
|
Thanks for wanting to contribute to Vac specs!
|
||||||
|
|
||||||
|
## Issues and PRs
|
||||||
|
|
||||||
|
Open an issue with a problem statement and suggested approach, where relevant, and a PR that links to this issue.
|
||||||
|
|
||||||
|
If it is a minor cosmetic change this can be pushed as a PR directly.
|
||||||
|
|
||||||
|
To make sure people don't miss your PR, ask for review from people of the Vac team in the PR.
|
||||||
|
|
||||||
|
## Spec lifecycle
|
||||||
|
|
||||||
|
Every spec has its own lifecycle that shows its maturity. We indicate this in a similar fashion to [COSS Lifecycle](https://rfc.unprotocols.org/spec:2/COSS/):
|
||||||
|
|
||||||
|
![](assets/lifecycle.png)
|
||||||
|
|
||||||
|
## Spec releases and changelog
|
||||||
|
|
||||||
|
The way we do releases is:
|
||||||
|
|
||||||
|
1. People approve PR
|
||||||
|
2. Squash commits in PR
|
||||||
|
3. Add one more commit to PR with commit info to previously squashed PR in the "Released on"
|
||||||
|
4. Merge rebase
|
||||||
|
|
||||||
|
This means the PR results in two commits on master, with the commit hash of a
|
||||||
|
release leading to all the changes done in that release.
|
||||||
|
|
||||||
|
Changelog is appended to in reverse chronological order with a summary of changes.
|
||||||
|
|
||||||
|
In cases where a release hasn't been cut, add a section "Next version" with a
|
||||||
|
summary of changes in the PR. This makes it easy to make sure each changelog is
|
||||||
|
accurate with actual diff from previous version.
|
||||||
|
|
||||||
|
## Questions
|
||||||
|
|
||||||
|
Ask these in #vacp2p or #waku, or open an issue.
|
Binary file not shown.
After Width: | Height: | Size: 42 KiB |
Loading…
Reference in New Issue