Skip to content

Latest commit

 

History

History
43 lines (34 loc) · 2.55 KB

CONTRIBUTING.md

File metadata and controls

43 lines (34 loc) · 2.55 KB

Luuppi ry contributing guidelines

General guidelines for developers

Important

If you are a developer wanting to make any changes to the codebase, you should always open an issue first to initiate a discussion about whether the change is needed. This is especially important for larger features. After receiving confirmation that the change is indeed required, you can be sure that you are not wasting your time coding something that won't be merged.

Did you find a bug?

  • Do not open up a GitHub issue if the bug is a security vulnerability. Contact WWW/IT-team via email [email protected].
  • Ensure the bug was not already reported by searching on GitHub under Issues.
  • If you are unable to find an open issue addressing the problem, open a new one. Please fill out the corresponding bug report template and answer all questions to the best of your knowledge.
  • The threshold for opening an issue is low. You can, and indeed should, open an issue even if you are unsure whether something constitutes a bug. There is no harm in doing that.

Do you have a new feature in mind?

  • You can also open an issue regarding new features using the feature template.
  • Similarly to bug report cases, make sure there is no open issue regarding this feature request.

Commit messages

  • There are no strict limits on what your commit message should look like. However, you should follow general best practices regarding commit messages.
Short (72 chars or less) summary

More detailed explanatory text. Wrap it to 72 characters. The blank
line separating the summary from the body is critical (unless you omit
the body entirely).

Write your commit message in the imperative: "Fix bug" and not "Fixed
bug" or "Fixes bug." This convention matches up with commit messages
generated by commands like git merge and git revert.

Further paragraphs come after blank lines.

- Bullet points are okay, too.
- Typically a hyphen or asterisk is used for the bullet, followed by a
  single space. Use a hanging indent.

(source)

License

By contributing, you agree that your contributions will be licensed under its MIT License.



Thanks to all contributors! 🔁 + ❤️ + 🫵

Luuppi ry