-
Notifications
You must be signed in to change notification settings - Fork 2.9k
Getting Started With Contributing
A lot of new contributors that want to dive in to helping fix bugs and develop new awesome things often ask "Well, where do I start?". Below are some links to comprehensive resources so that newcomers can get up to speed and get dive right in to fixing bugs.
All of Diaspora's code is hosted on GitHub, a social coding platform that leverages Git for many different Free and Open Source projects. You can use any operating system to contribute with GitHub, all you need is an account and to follow GitHub's guide for setting up your account from the command line and learning to use the commands. Git is supported on all major platforms.
There are a couple different places worth considering for finding good bugs. You can always check the GitHub Issues queue, but sometimes it's not quite clear what the scope of a bug might entail. Maybe a random bug you find might be a really big bug that requires a lot of code, and maybe you're not up for that yet. To help get newcomers more up to speed with how Diaspora works, we started something called Bug Mash Monday, a weekly bug sprint in which newcomers can co-ordinate with other contributors to get parts of the system fixed up. It teaches you how the system works, and in return, you get community recognition and shoutouts for the fixes you make. (Note: that particular blog entry is old and purely exists as an example, check the devblog for the latest update for bugs to fix!)
Diaspora's development tries its very best to stick to a set of guidelines when it comes to contributing code. When you're writing a bugfix or custom code from scratch, it's good practice to ask yourself:
- Does my code have tests?
- Am I sticking to the Git Workflow the best I can?
Below are some helpful relevant links to other parts of the wiki. We're currently restructuring everything, so the below links may be subject to change.