Files
Niklas Wimmer 32504d3092 docs: Rewrite the contributing guide
Expanded the introduction and possible areas of contribution. Also
improved structure and added more links to communication channels.

Removed the description of how patches can be submitted, in favour
of a more prominent link to welcome.gnome.org, which provides this
information in much more depth.

Part-of: <https://gitlab.gnome.org/GNOME/gnome-calendar/-/merge_requests/855>
2026-09-30 18:30:44 +00:00

78 lines
3.4 KiB
Markdown

# Contributing
Thank you for considering contributing to the GNOME Calendar project! These guidelines are meant
for new contributors, regardless of their level of proficiency; following them allows other
contributors to the GNOME Calendar project to more effectively evaluate your contribution, and
provide prompt feedback to you. Additionally, by following these guidelines you clearly communicate
that you respect the time and effort that the people working on GNOME Calendar put into managing
the project.
GNOME Calendar is free software, and it would not exist without contributions from the free
software community. There are many things that we value:
- Issue triages
- Bug reports
- Feature requests
- User experience reports
- Translations
- User interface designs
- Documentation improvements
- Patch reviews
- Test additions
- Bug fixes
- Performance enhancements
- Source code cleanups
- Feature implementations
If you are interested in helping us with any of these categories (or anything else that we did not
think about when writing this), then please read on to learn more about our guidelines and
processes :)
## Code of Conduct
When interacting with the project, the [GNOME Code of Conduct](https://conduct.gnome.org/) applies.
## Use of Generative AI
This project does not allow contributions generated by large languages models (LLMs) and chatbots.
This ban includes tools like ChatGPT, Claude, Copilot, DeepSeek, and Devin AI. We are taking these
steps as precaution due to the potential negative influence of AI generated content on quality, as
well as likely copyright violations.
This ban of AI generated content applies to all parts of the projects, including, but not limited
to, code, documentation, issues, and artworks. An exception applies for purely translating texts
for issues and comments to English.
AI tools can be used to answer questions and find information. However, we encourage contributors
to avoid them in favor of using [existing documentation](https://developer.gnome.org) and our
[chats and forums](https://welcome.gnome.org). Since AI generated information is frequently
misleading or false, we cannot supply support on anything referencing AI output.
## Communication Channels
- Technical discussions happen in the issue tracker and on proposed patches directly, which are both
hosted on [GNOME's Git forge][forge].
- Day-to-day conversations, coordination and socialising with other contributors happens primarily
in our group chat on [Matrix][matrix].
- Support for users is provided on [GNOME Discourse][discourse], in the "Applications" category,
using the "calendar" tag.
# Next Steps
- Check out [GNOME Calendar on welcome.gnome.org][welcome], which contains concrete steps and
instructions on how to contribute in a variety of different ways.
- Join our group chat on [Matrix][matrix]! We are happy to assist you with your contribution, as
well as having a nice chat about all things Calendar :)
- If you intend to work on the source code of GNOME Calendar directly, you may want to check out our
[Hacking Guide][hacking], which explains how to work with the code base in more depth.
[forge]: https://gitlab.gnome.org/GNOME/gnome-calendar/
[welcome]: https://welcome.gnome.org/en-GB/app/Calendar/
[matrix]: https://matrix.to/#/#gnome-calendar:gnome.org/
[discourse]: https://discourse.gnome.org/tags/c/applications/7/calendar/22
[hacking]: ./HACKING.md