We are really glad you're reading this, because if you are then you have shown an interest in helping make LinuxGSM great.
If you haven't already, come find us on Discord. From there you will have contact with other contributers of the project. We want you working on things you're excited about.
Before working on a project we recommend that you create a issue in regards to the issue/feature. This will prevent duplicates while you work on the feature. If an issue already exists, make note that you are working on it so nobody else wastes their time working on the same project at the same time!
Here are some important resources:
- Issues Page provides a list of areas that could use some work,
- Developing LinuxGSM gives a detailed guide on developing LGSM,
- LinuxGSM Exit Codes describes and gives an explanation for exit codes,
- gsquery describes the uses of the gsquery.py file, and
- Branching is our final guide to submitting changes.
Please make sure all the code you write is working properly before you create a pull request. Information on debugging can be found in the following document: Developer Commands Debugging your code
Please send a GitHub Pull Request to LinuxGSM with a clear list of what you've done (read more about pull requests). Please follow our coding conventions (below) and make sure all of your commits are atomic (one feature per commit).
Always write a clear log message for your commits. One-line messages are fine for small changes, but bigger changes should look like this:
$ git commit -m "A brief summary of the commit
>
> A paragraph describing what changed and its impact."
This will help us in understanding your code and determining where problems may arise.
Start reading our code and you'll get the hang of it. Explore how functions are organized and you'll see how we strive for readable code.
Please give the following document a read and adjust your code according to its specifications. Syntax & Coding Conventions