Skip to content

docs: add CONTRIBUTING.md#353

Open
SanjeevLakhwani wants to merge 7 commits into
releases/v24from
docs/contributing
Open

docs: add CONTRIBUTING.md#353
SanjeevLakhwani wants to merge 7 commits into
releases/v24from
docs/contributing

Conversation

@SanjeevLakhwani

Copy link
Copy Markdown
Contributor

Summary

  • Adds a platform-wide CONTRIBUTING.md covering branch naming, commit conventions, PR process, bug/security reporting, and licensing.

Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md
Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md
Comment thread CONTRIBUTING.md Outdated

@davidlougheed davidlougheed left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

looks good, although we will need to add in notes about AI to fully address what was discussed in meetings (maybe next version?)

final approval should come from @dbujold for this PR.

Comment thread CONTRIBUTING.md
- `chore/<short-description>` — tooling, dependency bumps
- `docs/<short-description>` — documentation-only changes

Including the Redmine ticket ID is encouraged, e.g. `feature/1234-add-search-endpoint`.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Not sure why this is "encouraged" when we don't seem to do it ourselves. At most I would expect the ticket number in the text of the pr, but even that seems rare.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

I mean before adding it as a requirement here, I would just confirm with the team on this.

Comment thread CONTRIBUTING.md
Comment thread CONTRIBUTING.md
- Use a clear, conventional-commit-style title (e.g., `feat(<scope>): add X` or `fix: handle Y`).
- In the description, include:
- A short summary of the change and why it's needed.
- A link to the relevant Redmine ticket.

@gsfk gsfk Jun 3, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

For Redmine, I thought we agreed that ticket numbers are sufficient.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

would just confirm with the team today and then add

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