1## How to contribute to Caroster
 2Caroster is an open-source project maintained by the [Caroster Team](https://fr.glassfrog.com/organizations/14555/orgnav/roles/13689524/overview).
 3We appreciate your interest in contributing to Caroster!
 4
 5All work is done on our [Gitlab](https://git.octree.ch/p/caroster) and mirrored to Github.
 6
 7There is many way you can contribute to Caroster, as Caroster is a volunteer effort:
 8
 9#### **Test Caroster**
10Testing the functionnalities are highly important for us. To test the last stable version, you can go on [caroster.io](https://caroster.io). 
11If you want to test the last unstable version and have the skills to run a Caroster locally, you are also more than welcome.
12
13To [open a new one](https://git.octree.ch/p/caroster/-/issues/new) please mind to share: 
14- What did you do before the issue happens?
15- With what device (browser, OS, mobile)?
16- What did you expect? 
17- What did happen ? 
18
19Screenshots, URLs are also more than welcome. Code samples and executable test cases are the bests.
20
21Please mind: 
221. **Do not open up an issue if the bug is a security vulnerability**, and instead to send an email to caroster@octree.ch.
232. **Ensure the issue was not already reported** by searching on GitLab under [Issues](https://git.octree.ch/p/caroster/-/issues).
24
25#### **Contribute to bug fixes**
26
27- Open a new GitLab merge request with the fix.
28- Ensure the PR description clearly describes the problem and solution. Include the relevant issue number if applicable.
29- Add tests that demonstrate the fix.
30
31#### **Translate Caroster**
32
33- You can follow the detailed process here : [Translating the Caroster app as a contributor ](https://octreegva.notion.site/Translating-the-Caroster-app-as-a-contributor-13612ef1253c8021abb0fcb2512fe8fe)
34- Go to [the weblate project](https://translate.codeberg.org/projects/caroster/web-app/).
35- Read and accept the contributor agreement.
36- Refer to [Weblate documentation](https://docs.weblate.org/en/latest/user/translating.html) to learn how to use Weblate.
37
38#### **Add or change Features**
39
40- Suggest your proposal in [https://feedback.caroster.io/](https://feedback.caroster.io/) with the following information:
41  1. A title and description of your proposal
42  2. How this feature or change will impact your use
43  3. If you are willing to develop the feature yourself
44- Our Caroster Product Owner will review your proposal (and may contact you by email or on the feecdback platform). 
45- If your proposal has been accepted and you are willing to develop it, someone from the product team will contact you to help!
46
47### **Propose a change (RFC)**
48To propose an architectural change of the code, a change of the contribution process, or any changes that is not related to a specific area of the code, open a RFC!
49A Request For Comment is an issue that introduce a discussion you want to have with the community or the Caroster Team.
50
51A Request For Comment need to have the following information: 
52- Context: Why do you request comment at the first place?
53- Proposal: What would you like to propose?
54- Alternatives: What did you think as an alternative
55- Expectation: Do you need a decision? Just an open discussion?
56
57We do not expect RFC's author to stay accountable for the implementation of anything after posting a proposal.
58We will though close a RFC if the author stays unresponsive for more than a month. 
59
60### **Contribute to the documentation**
61For now, we do not maintain documentation beyond the README.md. If you have suggestion, please open a RFC.
62
63### **Support financialy**
64Support financially the Caroster Team on [opencollective](https://opencollective.com/caroster#category-CONTRIBUTE) is a great help for us.
65
66### **Promote Caroster.io**
67Follow, share, comment on social media helps us greatly. 
68- Linkedin: [caroster](https://www.linkedin.com/company/caroster/posts)
69- Mastodon (in french): [@caroster](https://piaille.fr/@caroster)
70
71If you plan to talk about caroster in events, please send us an email to spread the news! (caroster@octree.ch)
72
73
74---
75
76
77Thanks! :heart:
78
79Caroster Team