Contributing to dahliaOS
dahliaOS is open to contributions. Any contribution is appreciated, whether it is a documentation update, localization, bug fix or a new feature. Anyone can contribute as long as they follow this guideline and obey the dahliaOS Code of Conduct. To make sure your contributions go as smooth as possible, here are all the things you need to know.
Communication with core dahliaOS development team is crucial for any successful participation in dahliaOS development. There are several methods to communicate with the core team:
- Discord (opens in a new tab) - We use Discord for pinging people, sharing updates, quick and informal discussions, questions and answers, etc. It is OK to discuss your contribution, planned contribution, development idea, localization, documentation updates and similar topics in this server. Anyone interested in the project is welcome to join our Discord server and hang around.
- Telegram (opens in a new tab) - Same as Discord.
- Issues / pull requests (opens in a new tab) - Most of the work is discussed here, including upgrades and proposals for upgrades, bug fixing and feature requests. For any of these, open an issue in the corresponding repository. If you are proposing code change, open a pull request.
Each of them is intended for an specific purpose. Please understand that you may be redirected to some other mean if the communication you intend to have is considered to fit better elsewhere.
This project and everyone participating in it is governed by our Code of Conduct and no one is exempt. By participating, you are expected to respect and value this code. dahliaOS Code of Conduct can be found here. If you notice any unacceptable behaviour, we encourage you to report it to email@example.com
In this document we've explained how you can contribute to our project, if you'd like to help out in a different way that is not documented here, you're always free to join our Discord and discuss other options you have in mind with our team.
You can contribute to the project by:
- Reporting a bug.
- Proposing new features.
- Translating to your native language.
- Submitting a fix.
- Discussing the current state of code.
- Becoming a maintainer.
- Making a financial contribution.
If you've experienced a bug and you'd like to report it, we highly recommend that you read Before submitting a bug report and Writing a good bug report first, and that you also use our issue template.
There are 2 ways you can report a bug, either in our Discord server by opening a ticket or by creating an issue using the bug report template on GitHub.
Before submitting a bug report, there are a few things you need to take in consideration:
- Do a bit of research and check if a similar bug has already been reported.
- If it has been reported already, add a comment to the existing one instead of submitting a new one.
We have a few short tips for you on how to properly write a bug report so the developers can understand it better:
- Use a clear and descriptive title for the issue.
- Describe the steps to reproduce the bug.
- Describe what behaviour you observed after the bug occurred.
- Explain what behaviour you expected to see instead and why.
- If the problem wasn't triggered by a specific action, describe what you were doing before it happened.
- Include screenshots of the bug.
- Write what version of dahliaOS you were using.
And the most important of all make sure to fill in as many fields as possible in our bug report template.
- Click the Issues tab
- Click New issue
- Select the Bug report template
- Fill in the fields
- Go to the #bug-report channel
- Open a ticket and copy the form
- Paste and fill in the form
If you'd like to see something added to dahliaOS, we highly recommend that you read Before submitting a feature request and Submitting a feature request first, and that you also use our feature request template.
To submit a feature request, create an issue using the feature request template on GitHub.
Before submitting a feature request, here are a few things you need to know:
- Make sure the feature isn't already added.
- Don't hesitate to express your knowledge.
- Write a clear and descriptive title for the request.
- Explain how the project could benefit of your request.
- Click the Issues tab
- Click New issue
- Select the Feature request template
- Fill in the fields
Pull requests to our repositories are always welcome and can be a quick way to get your fix or improvement slated for the next release. In general, pull requests should:
- Fix an existing issue or add a new feature.
- Be accompanied by a complete pull request template (loaded automatically when a pull request is created).
For changes that address core functionality or would require breaking changes (e.g. a major release), it's best to open an issue to discuss your proposal first. This is not required but can save time creating and reviewing changes.
To make sure that the pull request you want to submit is up to our standards, we've written a few dos and don'ts:
- Provide a meaningful commit message.
- The first line of the commit message should have the format "Category: Brief description of what's being changed". The "category" can be a subdirectory, but also something like "POSIX compliance" or "ClassName".
- Write your commit messages in proper English, with care and punctuation.
- Use the present tense ("Add feature" not "Added feature")
- Use the imperative mood ("Move cursor to..." not "Moves cursor to...")
- Limit the first line to 72 characters or less
- You may want to create a topic branch for larger contributions.
- Split your changes into separate commits.
- Touch anything outside the stated scope of the pull request.
- Use weasel-words like "refactor" or "fix" to avoid explaining what's being changed.
- Fork the repository to your own GitHub account
- Clone the project to your machine
- Make your changes
- Push changes to your fork
- Open a pull request in our repository and fill in the pull request template
We kindly ask everyone who has submitted a pull request to be patient, we notice every new pull request so don't worry about it being ignored, we'll be on it as soon as possible.
We aim to provide our software in as many languages as possible so everyone could experience it in their own native language. For submitting translations, we use Crowdin so please do not edit the files found in the repositories. If you're interesting in translating our project, click here (opens in a new tab). Note: If the language you're looking to translate to is not added, let us know and we'll add it right away.
Before making a translation, please make sure that:
- You're fluent in the language you're translating to.
- You pay close attention to grammar.
- You read the context (comments) some strings have.
- You used the same punctuation as the source strings.
- Create a Crowdin account (if you already don't have one)
- Join our workspace
- Pick a project to translate
- Apply translations to the available strings
To make sure that the code you want to contribute is up to our standards, we've written a few dos and don'ts:
- Choose expressive variable, function and class names, make it as obvious as possible of what the code is doing.
- Submit code that's incompatible with the project license (Apache 2.0).
- Include commented-out code.
If you're not yet familiar with the development of dahliaOS, you can tackle tasks labeled with the "good first issue" label on our GitHub as they are more suited for newcomers looking to gain some experience.
Apart from code contributions, we also accept various kinds of design contributions.
Here are a few repositories where you can contribute designs:
- wallpapers (opens in a new tab)
- Contribute your own wallpapers made for dahliaOS.
- icons (opens in a new tab)
- Contribute/propose new or modified icons for dahliaOS.
- brand (opens in a new tab)
- Contribute/propose new or modified logos of our brand.
- press-kit (opens in a new tab)
- Contribute mockups, screenshots, graphics, marketing material and such for dahliaOS.
We love seeing concepts and designs, feel free to share them with us on our social media!
dahliaOS is an Apache 2.0-licensed free open source project that financially relies mainly on donations. Donations helps us pay the bills (web hosts, domains, software/hardware, etc.) to keep this project on its feet as long as possible. If you're interested in sending a donation to dahliaOS, click here (opens in a new tab) to find out where you can do so. Another way you can find donation links is by clicking the Sponsors button in most of our GitHub repositories.
If you're interested in contributing to dahliaOS but don't know what you can assist us with, you can find available tasks by:
- Peeking at GitHub issues / projects
- Asking in our Discord or Telegram
By contributing to dahliaOS, you agree that your contributions will be licensed under the Apache 2.0 (opens in a new tab) license.