Code for Good: Open Source Solutions for Social Impact 2023

[CeciliaHinga]

Welcome to Ushahidi and the Code for Good Hackathon!

We are so excited you are here!! We'd love to celebrate Open Source with you in October 2023 🌻 🎉 💐

We have compiled a list of helpful resources and steps to help you make successful contributions. Ensure not to skip any of the steps below.

Step 1 - Get familiar with the Ushahidi community:
Read through our Code of Conduct
Join and say hello on our community Gitter channel to communicate, help and get help from the community.
Step 2 - Get your developer environment setup (If you get stuck, reach out to the community Gitter channel to get help):
Checkout the instructions to setup and launch our platform client (mzima) locally.
Check out the instructions to set up and launch our backend platform API locally.
Step 3 - Explore the Ushahidi Platform and the different concepts like surveys (also called "forms" in some places) and posts. You can explore by studying and clicking around on the platform's user interface, or through our user documentation (Note: that the user documentation still uses the legacy/old platform client in its examples, but the functionalities are largely the same. You can get clarification about any confusing thing on the community Gitter channel)
Share your successful setup: Once you have completed steps 1-4, send a reply to this discussion with screenshots of your setup in the browser and select an issue to work with.

Finding issues tickets to work on and working on issues: You can find issues to work on through our OSS community board. We have made it easy - check for issue tickets with the hacktoberfest label on them, you will also find the difficulty level on the issue tickets to help you easily identify those that you can tackle based on your experience and/or strengths. Take note of these when working on issues:

You can only work on one issue at a time. We are looking for the quality of the contributions rather than the number of contributions when evaluating the applications.
Once you are assigned to an issue, we want you to submit a pull request within 2 days, even if it is not yet complete or a working solution. This is to make our contributors work "in the open" as is often done in Open Source, and make sure no issues are not being worked on. If you don't show progress within 3 days, we will open it up for other participants. GitHub has a good guide on how to submit pull requests from a fork.

Privacy info/personal info: During the application-process, Ushahidi will store your Github-handle in a google-sheet. This is done only to make the application process as smooth as possible and to keep track of which issues are being worked on and the progress of each issue. The information stored will be deleted once the application-process is over.