CONTRIBUTE.md

Contribuer au wiki de Plutonium

Cet endroit a été créer pour permettre aux membres de la communautées de pouvoir contribuer au développement et à la vie de ce lieu. Pour pouvoir participer, il faut connaitre certaine base, et effectuer certaine étapes dans l'ordre, que nous allons vous expliquer ici.

Sommaire

• Proposer des modifications
  • Ouvrir une issue
• Contribuer par soi-même au wiki
  • Faire une copie du wiki
  • Modifier ou ajouter des fichiers au wiki
    • Modifier un fichier existant
    • Ajouter un fichier
  • Ouvrir une 'Pull request'

---

Proposer des modifications

Ouvrir une issue

1 - Se rendre à l'adresse https://github.com/Plutonium-Mcpe/pluto-wiki/issues/new/choose

Sélectionner la catégorie souhaitée

2 - Écrire ce que vous avez à nous dire en suivant le schéma proposé, ou en suivant le votre et cliquer sur 'Submit new issue'

3 - Rester à l'affût

---

Contribuer par soi-même au wiki

Faire une copie du wiki

N'ayant pas les droits, vous devrez effectuer une copie du wiki pour pouvoir effectuer vos modifications, avant de nous les proposer auprès de "Pull Request".

1 - Effectuer un 'Fork' du wiki en cliquant sur le bouton comme ci-dessous

2 - Laisser les paramètres par default et cliquer sur 'Create fork'

Vous avez désormais créer un 'Fork', une copie du wiki de plutonium où vous avez tout les droits.

Modifier ou ajouter des fichiers au wiki

Modifier un fichier existant

1 - Trouver le fichier à modifier en naviguant dans docs/...

Pour l'exemple, nous choisirons le fichier: docs/blocs/farming-chest.md

2 - Activer la modification en cliquant sur le crayon

3 - Modifier le fichier et sauvegarder en cliquant sur le bouton comme ci-dessous

Pour savoir comment sont écrit les articles, avec quelle syntaxe etc, suivre ce lien: ici

Une fois ceci fait, vous pouvez soit continuer à modifier, soit ajouter des fichiers, soit ouvrir une 'Pull request' pour nous soumettre vos propositions.

Ajouter un fichier

1 - Réflechir à l'endroit où le placer

Suivre l'architecture actuelle du wiki, et le nommage disponible ici

2 - Ajouter le fichier

Pour l'exemple, nous allons rajouter un article sur l'épée en diamant

3 - Éditer le fichier comme vous le souhaiter

Éditer le fichier en suivant les obligations et les règles disponibles ici

4 - Sauvegarder les modifications

Une fois ceci fait, vous pouvez soit continuer à ajouter, soit modifier des fichiers, soit ouvrir une 'Pull request' pour nous soumettre vos propositions.

Ouvrir une 'Pull request'

1 - Se rendre sur la page d'accueil de votre copier à l'adresse: https://github.com//pluto-wiki

Une alerte en jaune devrais être affiché vous notifiant qu'il y a des modifications que vous pouvez nous soumettre et cliquer comme indiquer OU Rien ne s'affiche de spécial, et cliquer comme sur le screen ci-dessous:

2 - Rédiger la 'Pull request' pour nous dire ce que vous avez modifié

Si vous n'obtenez pas comme le screen ci-dessous, chercher un bouton 'Create pull request' se situant souvent sur un fond bleu

3 - Vérifier vos données et soumettez nous vos modifications en cliquant sur 'Create pull request'

Veuillez à cocher la case: Allow edits by maintainers pour nous permettre de modifier si besoin vos fichiers

4 - Restez à l'afûts de nos questions et nos commentaires pour faciliter le traitement de la demande

Les éditeurs du wiki viendront regarder et traiter votre demande

---

Informations supplémentaires

Merci d'avance pour votre contribution, votre aide nous est d'une grande aide et nous vous en serons toujours reconnaissant.

En espérant que ce tutoriels vous auras été d'une grande, si celui-ci n'as pas été assez clair, ouvrez une 'Issue'.