Cette page est une traduction automatique, vérifiée sur l’original en anglais.
Contribuer
Un projet spatial three.js pour ta première pull request
Space Radar est une carte 3D de l’espace open source, construite avec three.js et de simples modules ES, sans étape de build. Le 1er novembre 2026, le projet avait 269 tickets « good first issue » ouverts que personne n’avait pris. Chacun nomme le fichier, le changement, la vérification à lancer et quand c’est terminé. Beaucoup n’ont pas besoin de three.js du tout.
La liste est celle de GitHub, elle est donc toujours à jour.
Choisis selon ce que tu aimes faire
| Domaine | Une tâche typique | Il te faut |
|---|---|---|
| Vérifier un chiffre par rapport à sa source | Indiquer la page et le jour où un chiffre a été lu, dans un commentaire YAML | un navigateur |
| Soigner les textes et les commentaires | Corriger un commentaire qui pointe vers un fichier qui a été déplacé | un navigateur |
| Écrire un test | Fixer ce que renvoie une petite fonction, dans un nouveau fichier de test | Node 22, ou un Codespace |
| Faire une petite modification du code | Faire qu’un script réponde à --help au lieu d’afficher une trace d’erreur | Python 3 ou Node 22 |
| Le CSS et l’apparence | Aligner une valeur d’espacement sur la grille de 4 px | un navigateur |
| Faire quelque chose qui se voit | Construire un petit simulateur dans un seul fichier HTML, sans bibliothèque | un navigateur |
À quoi ressemble le code
- L’application est servie telle quelle : ni bundler, ni framework. Clone-la, lance le serveur web intégré de Python, et elle s’ouvre.
- Le rendu est fait avec three.js. L’essentiel de ce que sait la carte se trouve dans des registres YAML, chaque ligne avec une source.
- Une seule commande,
scripts/check.sh, lance les vérifications rapides que passe une pull request et dit comment corriger chaque échec. - La licence est MIT.
Ce qui arrive à ta pull request
Si les vérifications sont au vert et que ce n’est pas un brouillon, elle est fusionnée toute seule, et ton nom figure dans les notes de version et dans la liste des contributeurs. Un changement de ce que fait le produit est d’abord discuté dans un ticket.
La plupart des commits viennent d’un compte opéré par des agents de programmation IA sous la responsabilité du fondateur du projet, et ce compte est soumis aux mêmes tests et aux mêmes sources que tout le monde. La page de gouvernance dit qui décide quoi, et il n’y a pas encore de relecteurs extérieurs : tu pourrais être la première personne.
Commencer ici
- Ta première pull request, en dix minutes
- Une carte du code en une page
- Toutes les personnes dont une pull request a été fusionnée
Tu cherches aussi ailleurs ?
GitHub tient une liste pour débutants pour la plupart des dépôts, à l’adresse qui se termine par /contribute ; celle de three.js lui-même est un bon endroit où chercher si tu veux travailler sur la bibliothèque plutôt que sur quelque chose construit avec elle.