Workflow for adding code
Last updated
Last updated
First, .
Ushahidi code development is happening in . We track all our tasks, both front-end and back-end, in issues connected to the repo .
Follow these guides to set up your developer environment:
The best way to pick a feature to work on is to say hi to Ushahidi’s developers in our , let us know what you’d like to work on (front end, back end, etc), and chat about what could be suitable for you. You can find more info on how to contact us here.
Ushahidi issues (bugs, feature requests, etc) are in Github Issues. Find something that needs doing.
in github are feature that are up for grabs by community devs.
If you’re working on an issue that nobody has claimed before, you will need to create a branch that is specific to this issue. To do this, cd (change directory) into your Ushahidi code in the terminal window, and type:
Where “some-task” is a short description without spaces of what this task is (e.g. “visualise-data”). Now you can start work on your code.
Now write your code.
When you’re ready to submit your code for approval, do this:
Commit and push your code
Click on "Compare and Pull Request" to create a pull request. Enter a title and description, then click "Create pull request".
The Ushahidi admins will then review and comment on your code, and will either accept your code or ask you to make changes to it. If you are asked to make changes to your code, make those changes then resubmit your code using:
If your code is accepted, then the admin will merge your pull request. Your code will then appear in the Ushahidi Platform GitHub repository, with you credited for it.
If you get stuck, or want to talk through ideas, you can ask for help in the .
Then, open your fork on github, ie. "". You’ll see a banner indicating that you’ve recently pushed a new branch, and that you can submit this branch “upstream,” to the original repository.
The first time you submit code you may be asked to sign Ushahidi’s .