Pour commencer avec le MDN Web Docs
Nous sommes une communauté ouverte de développeur·euse·s, rédacteur·ice·s techniques et apprenant·e·s 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 contributeur·ice·s pour vous aider à trouver des opportunités de contribution qui ont 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 sont 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 avez 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écessitent 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 examine votre écriture et vous aide à l'améliorer. Nous avons besoin de votre expertise technique, et nous vous aidons à 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 contributeur·ice·s, de choisir un problème et de nous le faire savoir en commentant le problème et en taguant l'équipe @mdn/fr-content.
Quelqu'un de l'équipe répond 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.
MDN Web Docs est un projet complexe avec de nombreux éléments en mouvement. Il est conseillé de se familiariser avec les différents dépôts de code.
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 (angl.) (ou une licence alternative déjà définie par la page que vous éditez). De plus, les exemples de code sont disponibles sous Creative Commons CC-0 (angl.) (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.