Bienvenue sur le Wiki Discord Francophone du site DFR.gg. 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 (draft) de Pull Request.
- Restez actif sur les Pull Requests. Précisez explicitement votre manque de disponibilité si vous en avez. Autrement, il est requis de pouvoir répondre présent sous 14 jours au message d'un reviewer.
- 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 reviewers 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 approuve la demande.
- 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 :
- Utilisez le style encyclopédique. Ce n'est pas un guide, c'est une banque d'informations sur tous les aspects de Discord. Restez neutre, impersonnel, clair, précis, compréhensible et didactique.
- Respectez une mise en forme correcte.
Commencez toujours un article par un paragraphe introductif incluant le titre de la page en gras.
Continuez par utiliser la mise en forme Markdown comme il vous semble utile, n'abusez pas de l'italique par exemple.
Aucun titre de niveau 1 n'est admis (
# Titre).
Exemple de page correcte (Voir la source) - 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.
Un reviewer pourra réaliser les images souhaitées, au besoin.
É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.dfr.gg, 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
Notre Discord des contributeurs : Discord FR
Blog officiel de Discord
Centre d'aide de Discord