3.9 KiB
Contributing to StupidOS
First, thanks for taking the time to contribute! 😻👍
[TOC]
Code of Conduct
This project and everyone participating in it is governed by the StupidOS Code of Conduct. By participating, you are expected to uphold this code. Please report unacceptable behavior to conduct@stupidos.d0p1.eu.
How Can I Contribute?
Reporting Bugs
This section guide you through submitting a bug report for StupidOS. Following these guidelines helps maintainers and the community understand your report, reproduce the behavior, and find related reports.
Before creating bug reports, please check this list as you might find out that you don't need to create one. When you are creating a bug report, please include as many details as possible.
Note: If you find a Closed issue that seems like it is the same thing that you're experiencing, open a new issue and include a link to the original issue in the body of your new one.
Before Submitting A Bug Report
- Perform a search to see if the problem has already been reported. If it has and the issue is still open, add a comment to the existing issue instead of opening a new one.
How Do I Submit A (GOOD) Bug Report?
Bugs are tracked as issues.
Explain the problem and include additional details to help maintainers reproduce the problem:
- Use a clear and descriptive title for the issue to identify the problem.
- Describe the exact steps which reproduce the problem in as many details as possible.
- Describe the behavior you observed after following the steps and point out what exactly is the problem with that behavior.
- Explain which behavior you expected to see instead and why.
- Include screenshots which clearly demonstrate the problem if needed.
- include a stack trace
- If the problem wasn't triggered by a specific action, describe what you were doing before the problem happened and share more information using the guidelines below.
Provide more context by answering these questions:
- Can you reliably reproduce the issue? If not, provide details about how often the problem happens and under which conditions it normally happens.
Include details about your configuration and environment:
- Which version of StupidOS are you using?
- Are you running StupidOS in a virtual machine? If so, which VM software are you using ?
- Are you running StupidOS on real hardware? If so, provide information about it.
Your First Code Contribution
Unsure where to begin contributing to StupidOS? You can start by looking through these good first issue
and help wanted
issues:
- Good first issues - issues which should only require a few lines of code, and a test or two.
- Help wanted issues - issues which should be a bit more involved than
good first issue
issues.
Both issue lists are sorted by total number of comments. While not perfect, number of comments is a reasonable proxy for impact a given change will have.
Styleguides
Git Commit Message
Git commit message MUST follow Coventional Commits convention
Other recommandations:
- Use the present tense ("add" instead of "added")
- Use the imperative mood ("move cursor to..." not "moves cursor to...")
Coding Style
You MUST follow our coding style
This text is based on the Atom's CONTRIBUTING.md