Our process follows a typical github project workflow.
- Fork our repos and download the code
- Hack on the code, making commits to the forked repos.
- Send us a pull request.
Always happy to accept patches, but we're also very interested in any new applications you may have written. Be sure to test them thoroughly and make sure they're stable before applying to have them accepted as part of the turtlebot core app suite.
- A github account of your own.
- Fork the repository that you want to hack on to your own account
For example, if you want to hack on turtlebot_apps, go to turtlebot_apps on github and hit the Fork button on the top right.
For convenience, copy the turtlebot source rosinstaller
- Modify it to point at your forked repositories.
Follow the Source Installation tutorial, pointing it at your modified rosinstall file.
Making a Pull Request
Hack on the code, making local commits.
Keep your commits small as its easier to parse and accept small chunks.
When you're happy, push your commits to your forked repo and finally hit the Pull Request button at the top of your forked repo's page on github.
Instant Pull Requests
If you're just making one or two line modifications to a file, a simpler way to make a pull request is simply to first view the file in one of the turtlebot repo's and then click the Edit button to the top right of the file viewer. Make your modifications and then when you save, github will automagically make a fork and send a pull request to the repo owner - too easy!