Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add missing EGSnrc contributor names since 2015 #966

Open
wants to merge 2 commits into
base: develop
Choose a base branch
from

Conversation

ftessier
Copy link
Member

@ftessier ftessier commented Feb 16, 2023

Add a fish script to check if contributor names are missing from the Contributors: list, according to commit authors. This script is meant to become a blocking github action for every pull request, but for the moment it can be run manually, e.g., as fish HEN_HOUSE/scripts/admin/check-authors.fish to review authorship of files that have been modified compared to the master branch (or add a commit reference as an argument to check since that commit)

Add the missing names of people who have modified EGSnrc files since the port to github in 2015(commit 4534cdd). The names are added under the Contributors: list in the file header. After this change, check-authors.fish 4534cdd4.. runs clean.

@ftessier ftessier requested a review from a team as a code owner February 16, 2023 03:58
@ftessier ftessier self-assigned this Feb 16, 2023
@ftessier ftessier added this to the Release 2024 milestone Feb 16, 2023
@ftessier ftessier force-pushed the add-missing-contributors branch 3 times, most recently from 1ed3b68 to e8b2eb6 Compare February 16, 2023 04:17
# Max Orok
# Reid Townson
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Double Reid seems to be added here?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Keen eye, thank you!

Authors of the EGSnrc files are unequivocally identified in the git
commit log. However, we also want to preserve the names of authors and
contributors inside text files headers, as much as possible, in case the
files are extracted from the repository (or the repository eventually
moves to another version control system).

This script compares, for each modified file in a commit range (passed
as the first argument, master..HEAD by default), the commit authors of
the file against the authors and contributors listed in the file header.
It reports the missing names, and returns 1 (error) if some authors are
missing, or 0 (success) otherwise. Binary files are excluded from the
comparison, as well as files that do not contain authorship information.
The latter are reported at the end of the output, skipping over files
that do not contain author information (e.g., image files).

This script is intended to run automatically as a github action. It
implies that all commit authors should be listed under "Contributors",
regardless of the significance of the contribution, so that the script
runs cleanly. The output of the github action should always be inspected
before merging to check the files that don't contain authorship
information.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

4 participants