Lignes directrices des contributions

Il n’y aura jamais trop de développeurs pour nous aider à améliorer l’API Sponge. Il n’existe pas de projet parfait et les choses peuvent toujours être améliorées. Si vous êtes un développeur intéressé par Sponge, n’hésitez pas, il n’y a qu’à suivre nos lignes directrices.

Note

Les développeurs qui montrent de la détermination et de la cohérence dans leurs contributions au projet peuvent être invités à rejoindre l’équipe de Sponge par les Chefs d’Équipe, à leur discrétion. Il n’y a aucun processus de demande formelle. Merrci de ne pas demander à l’équipe, nous vous demanderons.

Etapes générales

  1. Configurez votre espace de travail comme indiqué dans Préparation pour le développement.
  2. Assurez-vous de savoir utiliser Git et GitHub. Si vos connaissances ont besoin d’un petit rafraîchissement, jetez un œil ici: Comment utiliser Git(Hub)
  3. Recherchez les problèmes existants dans les dépôts de l’API Sponge, SpongeCommon, SpongeForge, SpongeVanilla, et SpongeDocs. Il y a peut être quelqu’un qui travaille sur la même chose que vous. Regardez également les problèmes marqués d’un tag « help wanted » pour les problèmes existants qui ont besoin de votre aide.

Note

Veuillez ne pas soumettre de contribution pour des changements de moins de 20 lignes. À la place, rejoignez #sponge sur IRC (irc.esper.net) ou #spongedev sur IRC (irc.esper.net) et nous effectuerons les changements avec d’autres.

  1. Si le problème nécessite un plus grand changement que vous voudrez peut-être de soumettre, les questions sans les changements sont nécessaires en premier lieu, afin que nous puissions confirmer la question et je sais que vous travaillez sur la résolution. Vous devez également créer un WIP (travaux en cours) avec la demande préfixé par `` [WIP] `` afin que nous pourrons commencer à les examiner en premier.
  2. Modifier le projet, cloner-le et apportez vos modifications dans une nouvelles branches.
  3. Testez vos modifications (assurez-vous qu’il soit compilé!) et quelles fonctionnent !
  4. Soumettez la demande avec un bref résumé de ce que vous avez changé et pourquoi il devrait être modifié dans ce sens.
  5. Si vous apportez des modifications supplémentaires, pousser les nouveaux commits à votre aide. ** N’écrasez pas vos modifications **, qui fait qu’il est extrêmement difficile de voir ce que vous avez changé par rapport à la version précédente de votre demande.
  6. Assurez-vous que votre contribution est basée sur les tout dernier changements de la branche avec laquelle vous tenter de fusionner. Si vous avez besoin d’aide pour la rebaser, vous pouvez demander!

Astuce

Si vous ne savez pas quelle branche vous devez baser votre travail sur, Découvrez nos Système de Gestion de Versions et Disposition de Branches du Dépôt avant de soumettre votre contribution.