Bienvenue sur le Wiki Discord Francophone du site Discord.fr. Nous avons pour objectif de répertorier une base conséquente d'informations, libre et accessible pour les utilisateurs de Discord. Vous pouvez retrouver sur notre wiki de nombreux articles sur des sujets divers, allant de la HypeSquad à la personnalisation du profil.
Nous ouvrons la modification de notre banque de données à tous ceux qui souhaitent y contribuer, et ce simplement grâce au fonctionnement de GitHub. Besoin de modifier un article ou suggérer la création d'une page ? On vous explique comment faire plus bas ! 😄
Afin que la gestion du wiki soit la plus efficace possible, plusieurs règles sont à suivre lors de la contribution :
-
Pas de duplication de Pull Request. Il est important de bien prendre en compte les Pull Requests actives avant d'en créer une, c'est aussi le cas pour les Issues. Si vous ne souhaitez pas que quelqu'un prenne l'article que vous comptez modifier, n'hésitez pas à créer un brouillon de Pull Request.
-
Restez actif sur les Pull Requests. L'équipe a un délai de 4 jours avant de vous répondre, mais vous vous devez d'être réactif à votre tour ; vous recevrez un rappel après 7 jours d'inactivité et la Pull Request sera fermée une semaine plus tard, faute de réponse.
-
Restez courtois dans vos échanges. Lorsque vous commentez des Pull Requests ou des Issues, merci de respecter autrui et de ne pas chercher à imposer votre vision. Si vous avez un doute, les membres de l'équipe auront le dernier mot.
*Les contributeurs commentant les Pull Requests ne sont là que pour suggérer des changements, seuls les maintainers vous demanderont de les effectuer.*
-
Ne créez pas de fichier par vous-même. Si jamais l'article que vous souhaitez rédiger n'est pas présent, ouvrez une Issue et suggérez l'ajout du fichier pour qu'un membre de l'équipe s'en occupe. Vous pouvez utiliser le modèle donné pour la suggestion d'article.
-
Un problème avec le wiki ? Ouvrez une issue. Si vous voyez une faute, une approximation, un changement à faire en général mais que vous ne souhaitez pas ouvrir de Pull Request, ouvrez plutôt une Issue pour informer les contributeurs volontaires de ce qu'il faut changer.
Le Wiki nécessite une forme de rédaction unie afin de le rendre accessible à tous. C'est pourquoi il est obligatoire de suivre certaines règles quand on rédige sur ce dernier :
-
Le wiki n'est pas un tutoriel. L'objectif du Wiki est de servir de banque de données sur tous les aspects de Discord. Il convient donc de rester purement informatif et ne pas expliquer pas à pas comment utiliser une fonctionnalité, ce n'est pas un guide.
-
Respectez une mise en forme correcte. Afin d'obtenir un rendu final correct et agréable à la lecture, il est conseillé d'utiliser la mise en forme markdown de la bonne façon. Commencez toujours les titres par ceux de niveau 2
## Titre
puis continuez sur les titres 3, puis 4, etc. N'abusez pas du gras ou de l'italique, par exemple.
Exemple de page correcte (Voir la source) -
Restez impersonnel. Comme plus haut, il est important de rester impersonnel et de parler d'utilisateur en général plutôt que du lecteur en particulier. Sont donc à proscrire les "vous", "vos", "votre" ou autres pronoms impliquant directement le lecteur.
-
Les images doivent être anonymes et centrées sur le sujet. Aucune mention d'un compte particulier ou de l'auteur de l'article ne doit apparaitre, il convient donc de faire des captures d'écran anonymes pour illustrer vos propos. Évitez également de prendre des captures trop larges et concentrez l'intérêt sur ce qu'il y a d'important.
Note: Toutes les images doivent être hébergées sur le service d'images i.discord.fr, n'hésitez pas à demander à les faire héberger dans la Pull Request.
Nous avons créé un serveur Discord afin d'encourager l'entraide et la contribution sur le site Discord.fr, il nous permet de nous organiser et échanger entre contributeurs. Si vous souhaitez nous rejoindre, vous pouvez le faire en cliquant sur le bouton ci-dessus.
Syntaxe Markdown spécifique à Docusaurus