Contribution Guidelines
Branch Convention
Feature/Bug/Hotfix branches (feature/*-###, bug/*-###, hotfix/*
) are for features or bug fixes that are specifically associated with an existing issue ticket.
- These branches end with the issue ticket number that the branch is solving.
- Unit testing should be done on these feature branches to ensure that the branch works on an isolated level.
Integration branches (integration/*-###)
are for integration testing.
- This includes integration between Controls and other systems on the vehicle, as well as integration between our internal Applications/Drivers.
- Integration branches end with the issue ticket number for the specific integration being done.
Production branches (production/MX)
are for specific major releases of the codebase. master
will always host the latest version.
- When releasing a new version, a production branch will need to be created
- The tip of the production branch will always be the latest release for that vehicle
- See How to complete a Software Release for more.
Review Process
Commit frequently to your branch. A good rule of thumb is to push at natural stopping points + the end of each work session or workday, or more frequently that that if necessary. Create a pull request whenever you are ready to add you working code to the master branch. You must select 2 reviewers for approval. Any trained contributors are allowed to review and approve code. See our PR Template for more review guidelines.
Welcome to the University Wiki Service! Please use your IID (yourEID@eid.utexas.edu) when prompted for your email address during login or click here to enter your EID. If you are experiencing any issues loading content on pages, please try these steps to clear your browser cache.