- blockLayout : les prénoms d'un onglet se joignent avec t(' et '), l'onglet suit la langue
- Infobulle d'annulation : ⌘Z sur Mac, Ctrl Z ailleurs (withShortcut), clé « Annuler la modification »
- « Bientôt disponible. » devient un texte à part
- kinship/de.test.js passe par test-helpers.js (#224)
- CONTRIBUTING : chaque langue s'adresse à l'utilisateur selon son usage (vous, du)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
3.1 KiB
Contribuer à Parenthèse
Parenthèse est maintenu par une seule personne. Les retours sont les bienvenus, et quelques repères font gagner du temps à tout le monde.
Avant d'écrire du code
- Un bug ou une idée : ouvrez une issue avec le modèle correspondant.
- Une faille de sécurité : pas d'issue publique, suivez SECURITY.fr.md.
- Pour tout changement plus large qu'une correction, parlez-en d'abord dans une issue. Une pull request non discutée peut être refusée, même soignée.
- Préférez de petites pull requests ciblées : un sujet par PR, un diff qui se relit en quelques minutes.
Lancer le projet en local
Tout est dans la section « Développer » du README.
Tests
Avant d'ouvrir une pull request, faites passer ce que vérifie la CI :
npm --prefix frontend ci && npm --prefix frontend run lint && npm --prefix frontend test && npm --prefix frontend run build
npm --prefix landing ci && npm --prefix landing test && npm --prefix landing run build
npm --prefix backend ci && npm --prefix backend run prisma:generate && npm --prefix backend run build && npm --prefix backend test
La CI vérifie aussi que les migrations Prisma s'appliquent sur une base vide et reproduisent exactement backend/prisma/schema.prisma. Toute modification du schéma s'accompagne donc d'une migration (npm --prefix backend run prisma:migrate).
Si vous touchez à Docker ou à nginx, lancez docker compose up -d --build puis bash tools/docker-smoke.sh http://localhost.
Conventions
- L'interface est en français, en anglais et en allemand. Tout texte visible passe par
t()defrontend/src/i18n/index.js: le texte français sert de clé, sa traduction anglaise va dansfrontend/src/i18n/en/. Un test échoue si une traduction anglaise manque. Les autres langues retombent sur l'anglais : un nouveau texte n'a besoin que du français et de l'anglais. - Chaque langue s'adresse à l'utilisateur comme le font d'habitude les applis dans cette langue : « vous » en français, « du » en allemand. Une nouvelle traduction suit l'usage de sa langue, pas celui du français.
- Pas de nouvelle dépendance lourde (framework, bibliothèque d'interface, service externe) sans en avoir discuté dans une issue.
- La promesse du README tient : pas de publicité, et aucune mesure d'audience activée par défaut sur une instance auto-hébergée.
Licence des contributions
Parenthèse est publié sous PolyForm Noncommercial 1.0.0 et le reste.
En ouvrant une pull request, vous
- certifiez avoir écrit la contribution ou avoir le droit de la proposer, dans l'esprit du Developer Certificate of Origin. Signez vos commits avec
git commit -s, qui ajoute une ligneSigned-off-by; - accordez au mainteneur, Ilies Allali, une licence perpétuelle, irrévocable, mondiale et gratuite pour utiliser, modifier et proposer votre contribution sous d'autres licences, y compris commerciales.
Si vous ne pouvez pas l'accepter, dites-le dans la pull request avant sa fusion.