doc: Add maintainer guide
This commit is contained in:
parent
2692231b95
commit
ee8349a676
|
@ -34,6 +34,7 @@ Fast open-source firmware for the [PineTime smartwatch](https://www.pine64.org/p
|
||||||
- [Versioning](doc/versioning.md)
|
- [Versioning](doc/versioning.md)
|
||||||
- [Project branches](doc/branches.md)
|
- [Project branches](doc/branches.md)
|
||||||
- [Files included in the release notes](doc/filesInReleaseNotes.md)
|
- [Files included in the release notes](doc/filesInReleaseNotes.md)
|
||||||
|
- [Maintainer's guide](doc/maintainer-guide.md)
|
||||||
|
|
||||||
### Contributing
|
### Contributing
|
||||||
|
|
||||||
|
|
45
doc/maintainer-guide.md
Normal file
45
doc/maintainer-guide.md
Normal file
|
@ -0,0 +1,45 @@
|
||||||
|
# Reviewing PRs
|
||||||
|
|
||||||
|
Approving a PR means that the reviewer has deemed the PR ready to be merged.
|
||||||
|
|
||||||
|
There are two steps to reviewing PRs.
|
||||||
|
|
||||||
|
- Review the feature:
|
||||||
|
|
||||||
|
- Consider if the feature aligns with the [InfiniTime vision](InfiniTimeVision.md)
|
||||||
|
- Discuss alternative ideas or implementations
|
||||||
|
|
||||||
|
- Review the code:
|
||||||
|
|
||||||
|
- Check the quality of the code and make sure it conforms to the [coding conventions](coding-convention.md)
|
||||||
|
- Consider the maintainability of the code
|
||||||
|
- Test the code with at least InfiniSim or a PineTime
|
||||||
|
|
||||||
|
# Merging PRs
|
||||||
|
|
||||||
|
Two approvals from core developers is usually required to merge a PR.
|
||||||
|
Exceptions include urgent fixes
|
||||||
|
and small maintenance PRs by core developers,
|
||||||
|
that don't affect the apparent behaviour of the watch in any way.
|
||||||
|
|
||||||
|
All but the simulator check must be passed before merging a PR.
|
||||||
|
|
||||||
|
PRs are either rebase or squash merged,
|
||||||
|
depending on whether the commits satisfy the following requirements:
|
||||||
|
|
||||||
|
### Commits
|
||||||
|
|
||||||
|
- Commits that fix mistakes from previous commits must be squashed before merging a PR.
|
||||||
|
- The title and description of the commit must sufficiently explain the changes in the commit.
|
||||||
|
|
||||||
|
If these requirements are not met,
|
||||||
|
the PR must be squash merged,
|
||||||
|
and the merger must write a satisfactory description.
|
||||||
|
|
||||||
|
# Stale PRs
|
||||||
|
|
||||||
|
Work-in-Progress PRs shall be marked as draft.
|
||||||
|
|
||||||
|
Draft PRs with no activity by the author for 3 months may be closed as stale.
|
||||||
|
|
||||||
|
PRs with changes requested, but no activity by the author for 3 months may be closed as stale.
|
Loading…
Reference in a new issue