1## How to contribute to Caroster
 2
 3#### **Did you find a bug?**
 4
 5- **Do not open up an issue if the bug is a security vulnerability**, and instead to send an email to caroster@octree.ch.
 6
 7- **Ensure the bug was not already reported** by searching on GitLab under [Issues](https://git.octree.ch/p/caroster/-/issues).
 8
 9- If you're unable to find an open issue addressing the problem, [open a new one](https://git.octree.ch/p/caroster/-/issues/new). Be sure to include a **title and clear description**, as much relevant information as possible, and a **code sample** or an **executable test case** demonstrating the expected behavior that is not occurring.
10
11#### **Did you write a patch that fixes a bug?**
12
13- Open a new GitLab merge request with the patch.
14
15- Ensure the PR description clearly describes the problem and solution. Include the relevant issue number if applicable.
16
17#### **Do you want to translate Caroster?**
18
19- Go to [the weblate project](https://translate.codeberg.org/projects/caroster/web-app/).
20
21- Read and accept the contributor agreement.
22
23- Refer to [Weblate documentation](https://docs.weblate.org/en/latest/user/translating.html) to learn how to use Weblate.
24
25- You can also ask us for a [Tolgee access](https://tolgee.io/) which enables in context translation of the frontend app. Be aware we are not yet able to credit contributions made trough Tolgee which is entended for internal use at the moment.
26
27- In the other hand, you can setup your own development instance with your own Tolgee Project by simply importing locales files with the namespace "translation", the application supports Tolgee configuration using NEXT_PUBLIC_TOLGEE_API_KEY and NEXT_PUBLIC_TOLGEE_API_URL env variables located in the frontend folder. This way you can contribute to translations on your computer and commit the updated locales files. See [Tolgee documentation](https://tolgee.io/platform/) for that.
28
29#### **Do you intend to add a new feature or change an existing one?**
30
31- Suggest your proposal by creating a [new issue](https://git.octree.ch/p/caroster/-/issues/new).
32
33- When your proposal has been accepted by a maintainer, write your code then create a Pull Request linked to your issue.
34
35Caroster is a volunteer effort.
36
37Thanks! :heart:
38
39Caroster Team