Currently, we only allow people to commit via sending git patches, which are machine-generated text files describing all changes to a project. This is in order to allow people without knowledge of expected conventions in git hosting services such as GitHub to contribute to our work.

Download the repository

Download a compressed version of the remote here and unzip it. Then you’ll be ready to make changes.

Download git

Git is the most widely-used version control system, which helps us keep track of every modification. A variety of downloads are available here.

Make sure to set your username and e-mail correctly via the following commands:

git config --global user.name “INSERT USERNAME HERE”

git config --global user.name “INSERT E-MAIL HERE”

Test your changes

After making your desired changes, you should test them. There are a variety of web servers available out there which allow for local testing. If you’re on Linux and have busybox installed, you can begin a server on the current directory at port 8000 via the command:

busybox httpd -f -p 8000

And access it in your browser via the link:

http://localhost:8000

Commit your changes

If you’ve added any new files, include them in the repository via the command:

git add FILENAME

Where “FILENAME” stands for the path of the file.

Commit the changes via:

git commit

Remember to use best practices for commit messages.

See your commits

View your commit IDs and messages via:

git log

You will use the commit IDs to generate the patch file.

Get a patch file

For a single commit

Create a patch file for a single commit via:

git format-patch master id

Where id is the commit ID.

For a range of commits

Create a patch file for a range of commits via:

git format-patch master id1..id2

From commit ID id1 to id2.

Send us the patch file

Running git format-patch will have created a .patch file in the directory you ran it from. Send it either as an attachment or as plaintext e-mail to:

tbloc-patches (at) comrades (dot) sbs

Legal disclaimer

As per the LICENSE file, you agree to release all your contributions under the GNU General Public License, Version 3.