Skip to content

WIP: [#] Add CONTRIBUTING.md#1691

Draft
mattrpav wants to merge 2 commits intoapache:mainfrom
mattrpav:NO-JIRA-CONTRIBUTING
Draft

WIP: [#] Add CONTRIBUTING.md#1691
mattrpav wants to merge 2 commits intoapache:mainfrom
mattrpav:NO-JIRA-CONTRIBUTING

Conversation

@mattrpav
Copy link
Contributor

No description provided.

@mattrpav mattrpav self-assigned this Feb 17, 2026
Copy link
Member

@jbonofre jbonofre left a comment

Choose a reason for hiding this comment

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

Good idea !

FYI, here's CONTRIBUTING.md from Polaris that is interesting.

@@ -0,0 +1,62 @@
# Contributing Guidelines
Copy link
Member

Choose a reason for hiding this comment

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

The ASF header is missing here.


2. Apache ActiveMQ releases are monitored with reproducible builds to ensure published binaries match the source tree

## Credits
Copy link
Member

Choose a reason for hiding this comment

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

Not applicable here.


## Triaging Issues

## Code Contributions
Copy link
Member

Choose a reason for hiding this comment

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

We can have a GH Issue template to help there.

Copy link
Contributor

@jeanouii jeanouii left a comment

Choose a reason for hiding this comment

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

Good start


### Certification of origin

1. Apache ActiveMQ committers should sign all commits using an SSH key tied to their apache.org email address
Copy link
Contributor

Choose a reason for hiding this comment

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

I configured mine because I agree this is a good practise. But I think you should bring the discussion to the dev@ mailing list and most likely to a vote.

If you want to mention SSH, you should also mention GPG because most committers already have Apache signing keys for releases and it's pretty straight forward to reuse it to sign commits. (this is what I have done for instance).

Copy link
Member

Choose a reason for hiding this comment

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

FYI, that's not strictly required from ASF standpoint. I don't want to see anything that can be seen as "limiting" the contributions.
Not sure I'm a big fan here.

Copy link
Contributor Author

@mattrpav mattrpav Feb 19, 2026

Choose a reason for hiding this comment

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

This shouldn't be seen as limiting. The benefit of using SSH keys it that Github (or anyone else) never has the private secret. This is more secure all-around and starting to become the standard practice (and requirement!) for SOC2 and ISO security certifications used by enterprises (aka end users of ActiveMQ).

As a project, ActveMQ can present a strong, and modern security stance by having committers sign commits vs relying on GH secrets or passkeys.

edit: I'll make a ssh signing quick-start guide to accompany this to show how easy it is to use over passwords/tokens/passkeys.

Copy link
Member

Choose a reason for hiding this comment

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

My point is that it should not be required, but recommanded.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I agree we can mark the statement as 'should' for now.

I do think we should try to progress towards required. Perhaps we let the new processes settle in this year and review how its working.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

If you want to mention SSH, you should also mention GPG because most committers already have Apache signing keys for releases and it's pretty straight forward to reuse it to sign commits. (this is what I have done for instance).

One benefit of using SSH keys over GPG as it allows one key for git id/authn/authz and code signing.

@mattrpav mattrpav marked this pull request as draft February 19, 2026 15:57
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

Comments