############
Contributing
############

If you're interested in contributing to Builder and GNOME at large, we would love for you to join us!
Only with people like you can GNOME exist.
We love seeing people that use GNOME transform into people that create GNOME.

IRC
===

One great way to get started is to join us on IRC where you can chat with others who work on the Builder project.
The Builder developer team can be found on the `Builder IRC channel`_.

File A Bug
==========

If you think you've found a bug in Builder, head over to `Builder Bug Tracker`_ and file a report.
We will get back to you on any further details we need to track down the issue as soon as we can.
Filing bugs helps us improve the softwrae for everyone and we really appreciate your time.

For various spam reasons our bugtracker requires that you create an account.
We hope this minor inconvenience is not too much trouble.

Find A Bug To Work On
=====================

If you wish to start contributing code to Builder, simply pick a bug from this list of `newcomer bugs`_.

Building From Source
====================

One of the first steps to joining a software project is to build the software.
Check out the `GNOME Newcomers Tutorial`_ for how to build software for GNOME.
It includes a guide for how to build Builder, as well as many other GNOME software projects.

For the impatient, you can use ``jhbuild`` to simplify the build process.

.. note::

   We do not recommend installing jhbuild using your Linux distributions package manager as
   it will be out of date.

.. code-block:: sh


   git clone git://git.gnome.org/jhbuild.git
   cd jhbuild
   ./autogen.sh --simple-install
   make
   make install
   jhbuild sysdeps --install gnome-builder
   jhbuild build gnome-builder
   jhbuild run gnome-builder

Improve This Documentation
==========================

One great way to learn about a software project is to try to document it!
Writing great documentation can be both challenging and rewarding.
And writing great documentation requires you learn about the product.

This is one way to improve things for the next person while you explore the code-base.
You can find the documentation in the ``doc/`` directory of the `git repository`_.

Planning And Project Management
===============================

Many of us that work on the Builder code-base are great at writing code.
But we are not so great at managing schedules, planning feature priorities, and coordinating with other projects.
Helping us do this in Builder will make you a shepard of geeks.

.. _`Builder IRC channel`: irc://irc.gnome.org/#gnome-builder
.. _`Builder Bug Tracker`: https://bugzilla.gnome.org/enter_bug.cgi?product=gnome-builder
.. _`newcomer bugs`: https://bugzilla.gnome.org/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&columnlist=component%2Cchangeddate%2Cbug_severity%2Cpriority%2Cshort_desc&keywords=newcomers&list_id=193415&order=changeddate%20DESC%2Ccomponent&product=gnome-builder&resolution=---
.. _`GNOME Newcomers Tutorial`: https://wiki.gnome.org/Newcomers/BuildGnome
.. _`git repository`: https://git.gnome.org/browse/gnome-builder/tree

