Proposer du nouveau contenu ou des fonctionnalités
Nous sommes toujours intéressés par les suggestions de notre communauté concernant de nouveaux contenus ou fonctionnalités pour MDN Web Docs. Cependant, même si nous sommes ouverts aux suggestions, nous devons garder à l'esprit les points suivants :
- MDN Web Docs est géré par une petite équipe interne. Nous comptons également beaucoup sur nos partenaires et notre communauté pour nous aider à maintenir MDN Web Docs comme la meilleure ressource pour les développeur·euse·s web. Par conséquent, nous devons parfois refuser de nouveaux contenus ou fonctionnalités, car nous ne serions tout simplement pas en mesure de les maintenir à long terme.
- MDN Web Docs se concentre également sur la documentation des standards web ouverts ; certains contenus pourraient ne pas être adaptés. Cela ne signifie pas que l'idée ou le contenu n'est pas bon, mais simplement que MDN Web Docs n'est pas le meilleur endroit pour cela.
En gardant cela à l'esprit, si vous souhaitez proposer du contenu ou des fonctionnalités pour MDN Web Docs, veuillez suivre les étapes ci-dessous.
Ouvrir un problème de suggestions de contenu et de propositions de fonctionnalités
Lorsque vous allez ouvrir un nouveau problème (dépôt anglais uniquement) (angl.), vous trouverez un modèle appelé « Nouvelles suggestions de contenu ou de fonctionnalités ». C'est le modèle de problème à utiliser lors de la suggestion de nouveau contenu ou de nouvelles fonctionnalités. Le modèle de problème nécessite pas mal d'informations, mais c'est très intentionnel.
- Cela garantit que nous avons toutes les informations nécessaires pour examiner votre proposition sans trop d'aller-retour.
- Cela vous aide à réfléchir à votre proposition en remplissant le formulaire.
Une fois que vous avez rempli le formulaire et soumis le problème, un membre de l'équipe principale vous répondra dans un délai d'une à deux semaines, en fonction de la complexité de votre proposition.
Participer à la discussion et attendre l'approbation
Si nous estimons que la proposition pourrait être appropriée, nous lançons une discussion (angl.) sur notre dépôt de discussions de la communauté MDN. Cela permet de recueillir les avis de nos partenaires et de la communauté au sens large. Nous vous encourageons à suivre la discussion et à y participer si nécessaire.
Ouvrir un problème
Supposons qu'un consensus soit atteint indiquant qu'il s'agit d'un contenu que nous voulons ajouter ou d'une fonctionnalité que nous voulons développer. Dans ce cas, nous ouvrons un problème dans le dépôt approprié en faisant référence à la proposition originale et à la discussion, et nous comblons les lacunes afin que le problème soit clairement exploitable.
Le travail est assigné
À ce stade, le travail est priorisé et assigné à ceux responsables de s'assurer qu'il est mis en œuvre et révisé.
Ouvrir une requête de tirage
Une fois que le travail est prêt pour la révision, une requête de tirage doit être ouverte, en faisant à nouveau référence à la proposition, à la discussion et au problème. Cela garantit que nous avons toujours le contexte complet du travail. Enfin, les personnes nécessaires sont assignées, et le processus de révision commence.
Révision et fusion
Ici encore, en fonction de la complexité du contenu ou de la fonctionnalité, l'étape de révision peut être longue. Nous vous demandons de faire preuve de patience et de continuer à vous impliquer si nécessaire. Une fois que nous avons l'approbation d'au moins deux membres de l'équipe interne, nous sommes prêts à fusionner la requête de tirage.
Cela conclut l'ensemble du processus, et le contenu ou la fonctionnalité est disponible sur MDN Web Docs.