Create CONTRIBUTIONS.md

This commit is contained in:
Christopher (Cris) Fuhrman 2025-05-29 14:55:34 -04:00 committed by GitHub
parent 069b62957f
commit 192afcc1bd
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

97
CONTRIBUTIONS.md Normal file
View file

@ -0,0 +1,97 @@
# 👩🧑‍💻 Contributing Guidelines / Guide de contribution
Thanks for your interest in contributing to this project!
Merci de votre intérêt pour ce projet !
To ensure a consistent and collaborative workflow, please follow these guidelines.
Pour assurer un flux de travail cohérent et collaboratif, veuillez suivre ces règles.
---
## ✅ Minimum Requirements for Every Pull Request (PR)
## ✅ Exigences minimales pour chaque Pull Request (PR)
Your code **must meet these criteria** before it can be merged into the `main` branch:
Votre code **doit répondre à ces critères** avant d'être fusionné dans la branche `main` :
1. **Peer Review Required**
**Révision par un pair requise**
Every PR must be reviewed and approved by at least one other student. You may not approve your own PR.
Chaque PR doit être relue et approuvée par au moins un autre étudiant. Vous ne pouvez pas approuver votre propre PR.
2. **Tests Must Pass**
**Les tests doivent réussir**
All tests must pass before merging. If your code breaks something, fix the issue before requesting review.
Tous les tests doivent réussir avant la fusion. Si votre code brise quelque chose, corrigez le problème avant de demander une révision.
3. **New Code Must Include Tests**
**Tout nouveau code doit inclure des tests**
Add unit or integration tests for new features. If youre unsure how, ask for help in your PR.
Ajoutez des tests unitaires ou dintégration pour les nouvelles fonctionnalités. Si vous ne savez pas comment faire, demandez de laide dans votre PR.
4. **Test Coverage Should Not Decrease**
**La couverture de tests ne doit pas diminuer**
Coverage must stay the same or improve. Small decreases may be acceptable with justification.
La couverture doit rester stable ou saméliorer. De légères diminutions peuvent être acceptées avec justification.
5. **Keep PRs Small and Focused**
**Gardez les PR petites et ciblées**
Submit pull requests that are small enough to review easily. Big PRs are harder to review and more likely to be rejected or delayed.
Soumettez des PR assez petites pour être faciles à relire. Les grosses PR sont plus difficiles à revoir et peuvent être retardées ou refusées.
6. **Pre-merge with Main Before Approval**
**Fusionnez avec `main` avant dêtre approuvé·e**
Make sure your branch is up to date with `main` before requesting review.
Dont leave merge conflicts for the reviewer to resolve.
Assurez-vous que votre branche est à jour avec `main` avant de demander une révision.
Ne laissez pas les conflits de fusion à la personne qui approuve.
---
## 📁 Branching and Workflow
## 📁 Branches et flux de travail
- Work on a feature branch (not `main`).
- Travaillez sur une branche dédiée (pas directement sur `main`).
- Use descriptive branch names: `feature/login`, `fix/typo`, etc.
- Utilisez des noms de branche explicites : `feature/login`, `fix/typo`, etc.
---
## 🧪 Running and Writing Tests
## 🧪 Exécuter et écrire des tests
- Run tests locally before pushing.
- Exécutez les tests localement avant de pousser.
- Follow the project's testing tools (e.g., Jest).
- Suivez les outils de test du projet (ex. Jest).
- Write small, clear tests that reflect the expected behavior, even for React pages.
- Écrivez des tests simples et clairs reflétant le comportement attendu, même pour les pages React.
---
## 🤝 Respect and Collaboration
## 🤝 Respect et collaboration
- Be constructive in code reviews.
- Soyez constructif dans les revues de code.
- Ask questions and give helpful feedback.
- Posez des questions et donnez des commentaires utiles.
- Dont approve PRs unless they meet the minimum requirements.
- Napprouvez pas les PR si elles ne répondent pas aux exigences minimales.
---
## 💬 Need Help?
## 💬 Besoin daide ?
Open a discussion or ask in the issue comments.
Ouvrez une discussion ou posez votre question dans les commentaires dun ticket.
Were all learning—no question is too small.
Nous sommes tous en apprentissage—aucune question nest trop simple.
---
Thank you for helping us build this project!
Merci de contribuer à ce projet !