1.7 KiB
1.7 KiB
Contributing
Workflow
A feature branch workflow is followed for this repository. All development work is done on ticket branches that are merged directly into the main branch.
Pre-requisite
- Verify that you have local git setup as mentioned in this guide
- A JIRA ticket should be created for the work you plan to contribute
Contribution Process
Branch Structure
main: Production-ready code. This branch should always be stable and deployable. All ticket branches are created from and merged into this branch.
Branch Naming Convention
Create branches using the following naming structure:
- Format:
ticket/<JIRA_TICKET_ID>
Examples:
ticket/PS-378ticket/PS-379
Step-by-Step Contribution Process
-
Create a branch from
maingit checkout main git pull origin main git checkout -b ticket/<JIRA_TICKET_ID> -
Follow standard development process:
- Effort Estimates
- Design Documentation (if required)
- Test Cases
- Code Implementation (following project coding standards)
-
Raise a Pull Request
- Create a PR from your ticket branch into the
mainbranch - PR title format:
(<JIRA_TICKET_ID>) <short description> - Add relevant documentation links in the PR description
- Update the PR link in the JIRA ticket comments
- Create a PR from your ticket branch into the
-
Code Review
- Address review comments
- Ensure all CI checks pass
- Get required approvals
-
Merge to Main
- Upon PR approval, squash and merge the ticket branch into
main - Delete the ticket branch after successful merge
- Upon PR approval, squash and merge the ticket branch into