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 co-authoring commits section to code-review #62

Merged
merged 5 commits into from
Jan 17, 2024
Merged

Conversation

joshwlambert
Copy link
Member

This PR adds a section detailing how to give recognition to collaborators through co-authoring commits. It is similar to
the As commit co-authors section in the Roles in package DESCRIPTION page, but the new additions give more details on some of the technical aspects of how to co-author commits.

This is information I've compiled that has helped me when suggestions are made in a PR but the changes are made on a different branch.

code-review.qmd Outdated Show resolved Hide resolved
code-review.qmd Outdated Show resolved Hide resolved
code-review.qmd Outdated Show resolved Hide resolved
Copy link
Member

@Bisaloo Bisaloo left a comment

Choose a reason for hiding this comment

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

Thanks!

@Bisaloo Bisaloo merged commit e26d453 into main Jan 17, 2024
2 checks passed
@Bisaloo Bisaloo deleted the git_coauthor branch January 17, 2024 09:37
@pratikunterwegs
Copy link

Only seeing this now as I've been away. I'm not sure I understand the use-case for the procedure decribed here. In reviews, accepted reviewer suggestions such as typo fixes are automatically co-authored commits, and any larger contributions are typically as PRs which also credit authors. Would it help to add to this section to say when manual crediting is needed - is there a common case I'm overlooking?

@joshwlambert
Copy link
Member Author

Agreed that in most cases, co-authorship is automatic by GitHub, however, when using suggestions in another PR the manual co-authorship is required: the use-case is outlined in Blueprints here: https://github.com/epiverse-trace/blueprints/blob/main/code-review.qmd#L32

@pratikunterwegs
Copy link

Ah I see thanks, sounds good.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants