Pour commencer avec le MDN Web Docs
Nous sommes une communauté ouverte de développeurs, rédacteurs techniques et apprenants qui construisent des ressources pour un Web meilleur, indépendamment de la marque, du navigateur ou de la plateforme. Tout le monde peut contribuer, et chaque personne qui contribue a un impact sur des millions de lecteurs. Découvrez comment contribuer et stimuler l'innovation sur le Web ouvert.
Que puis-je faire pour aider ?
Il existe plusieurs moyens de contribuer à MDN, en fonction de vos compétences et de vos intérêts. Par conséquent, avec chaque tâche, nous fournissons une brève description et un temps approximatif que chaque type de tâche prend généralement. Si vous ne savez pas quoi faire, vous pouvez toujours demander de l'aide dans l'un de nos canaux de communication.
Nous avons créé un tableau des tâches des contributeurs pour vous aider à trouver des opportunités de contribution qui auront un impact significatif sur le projet. Le tableau a un aperçu et des vues séparées pour des types de contribution spécifiques. Notez que notre petite mais puissante équipe de documentation maintient ce dépôt. Pour préserver notre bande passante, les conversations hors sujet seront fermées.
Note : Si vous débutez et que vous souhaitez commencer avec des sujets légers, consultez la section 👋🏻 Pour commencer
Qu'est-ce que j'ai besoin pour commencer ?
Pour contribuer, vous aurez besoin d'un compte GitHub. Si vous n'en avez pas déjà un, allez-y et inscrivez-vous pour un compte avant de continuer. Si vous êtes nouveau sur GitHub, nous vous encourageons à suivre les cours gratuits et auto-dirigés suivants et le matériel de lecture proposé par GitHub. Avec ces connaissances, vous pouvez vous concentrer sur vos contributions sans le fardeau d'apprendre un nouvel outil en même temps.
Note : Le cours « Introduction à GitHub » devrait suffire pour vous aider à démarrer. N'hésitez pas à passer à l'étape suivante et à revenir aux autres documents plus tard.
Nous vous recommandons également de lire le matériel d'apprentissage suivant :
- Étiquette de base pour les projets open source : Si vous n'avez jamais contribué à un projet open source auparavant, nous vous encourageons à lire ce document.
- Apprendre le développement web : Si vous êtes nouveau en HTML, CSS, JavaScript, nous avons d'excellents contenus pour vous aider à démarrer.
- Collaboration à l'aide de demandes de tirage
Certaines opportunités de contribution spécifiques à l'écriture nécessiteront une compréhension raisonnable de la langue anglaise. Cela dit, ne vous inquiétez pas si votre grammaire n'est pas parfaite : nous avons une équipe de personnes qui examinera votre écriture et vous aidera à l'améliorer. Nous avons besoin de votre expertise technique, et nous vous aiderons à peaufiner votre anglais afin de l'obtenir.
Choisir sur quoi travailler et se lancer
Une fois que vous avez décidé quel type de tâche vous souhaitez accomplir, il est temps de vous rendre sur le tableau des tâches des contributeurs, de choisir un problème et de nous le faire savoir en commentant le problème et en taguant l'équipe @mdn/yari-content-fr.
Quelqu'un de l'équipe répondra avec des commentaires, des conseils ou des orientations.
Assurez-vous de ne pas travailler sur quelque chose qui est déjà en cours - cela peut être frustrant de dupliquer ou de perdre du travail. En cas de doute, posez des questions sur le problème.
Autres façons de contribuer
Voici une liste de façons dont vous pouvez contribuer à MDN Web Docs :
- Travailler sur des problèmes problèmes à résoudre
- Examiner les demandes de tirage
- Aider les débutants dans notre communauté
- Aider à traduire MDN Web Docs
- Aider à corriger les problèmes connus du backend (angl.) et les problèmes connus du frontend (angl.)
- Aider à maintenir à jour les données de compatibilité des navigateurs (angl.)
Contributions
Lorsque vous contribuez, vous acceptez de rendre vos contributions disponibles sous la licence Attribution-ShareAlike (ou une licence alternative déjà spécifiée par la page que vous éditez). De plus, les exemples de code sont disponibles sous Creative Commons CC-0 (une dédicace au domaine public).
Si vous avez des questions ou des préoccupations concernant quoi que ce soit discuté ici, veuillez nous contacter.