Skip to content

Commit 4799593

Browse files
authored
Merge pull request #95 from prokoudine/master
Update list of maintainers, cover PR merge meetings
2 parents cd55595 + ab0eac9 commit 4799593

File tree

1 file changed

+9
-2
lines changed

1 file changed

+9
-2
lines changed

maintainersguide/index.md

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,10 +10,9 @@ Guidelines for Maintainers regarding code review and merge procedures. Git can
1010

1111
- Adrián Insaurralde Avalos: release manager, PR triage
1212
- Yorik van Havre: Arch/BIM, Spreadsheet
13-
- Brad "sliptonic" Collette: Path
13+
- Brad Collette: CAM
1414
- Werner Mayer: everything
1515
- WandererFan: TechDraw
16-
- abdullahtahiriyo: Sketcher
1716
- Bernd Hahnebach: FEM
1817
- Roy-043: Draft
1918
- OpenBrain: CI management
@@ -82,6 +81,14 @@ When possible Maintainers should use the web-based PR merge system on GitHub to
8281
2. Rebase and merge. The rebase process changes the commits, so eliminates any cryptographic commit signature that had been provided by the Contributor. It directly includes the commits in the main history of the repository, without any intervening merge commit. This arguably results in a "cleaner" commit history for the project as a whole. This is most appropriate for small, single-commit PRs.
8382
3. Squash and merge. In some cases a Contributor may not be comfortable using git, and may be unable to squash their own commit history into a reasonable number of well-defined commits. In those cases Maintainers have the option of squashing all commits into one during the merge process. This is most appropriate when working with those uncomfortable with using git, who have a needlessly complex commit history for a single simple task.
8483

84+
## Merge Meetings
85+
86+
Every Monday, FreeCAD maintainers meet on a Jitsi call for an hour to go through the list of open pull requests and apply the ones that are ready for merging. The recurring event is [available in the FPA calendar](https://www.freecad.org/events.php).
87+
88+
The call moderator opens the list of all open PRs, then the team of moderators goes through them in reverse chronological order: they look at submitted patches, discuss whether further changes need to happen, and collectively reach decision on merging or postponing the merge.
89+
90+
This event is open for everybody. Developers whose patches are undergoing review are encouraged to join the call in case maintainers have questions about the code / design decisions.
91+
8592
## Reverting
8693

8794
Under almost no circumstances should a Maintainer revert something that they did not themselves merge. If a serious issue is identified with a commit, the committing Maintainer and original Contributor should be notified by either commenting on the original Pull Request, commenting on the commits themselves, or (preferably) by creating a new GitHub Issue and mentioning them in it. It is expected that despite our best efforts, occasionally the master branch will fail to compile on some platforms, that serious unintended feature regressions will occur, etc. None of these things constitute a reason to revert the commit without discussion.

0 commit comments

Comments
 (0)