Aller au contenu

Contribuer à la Documentation

Nous acceptons les contributions de toute taille et de tout niveau de compétence. En tant que projet open-source, nous croyons qu’il faut laisser la main à nos contributeurs. Nous sommes heureux de vous aider avec des conseils sur la manière de proposer des PRs, la rédaction technique et en transformant toute idée de fonctionnalité en réalité.

Vous voulez vous impliquer encore plus ? Consultez notre document de gouvernance pour une description détaillée des différents rôles, des processus de nomination des mainteneurs, des processus de révision du code et de l’application du code de conduite.

Il y a de nombreuses façons de contribuer au projet Astro ! Chaque dépôt Astro a un README avec un lien vers un fichier CONTRIBUTING.md à la racine du projet.

Visitez le profil GitHub d’Astro pour trouver les dépôts suivants :

  • La base principale du code d’Astro, y compris les intégrations officielles et les modèles de démarrage.

  • La documentation d’Astro, un site web complet sur Astro ! Contribuez non seulement au contenu écrit, mais aussi au code Astro concernant a11y, CSS, UI et UX. Notre documentation est également disponible en plusieurs langues, nous avons donc besoin d’aide pour traduire l’ensemble du site.

  • Le compilateur Astro, écrit en Go, distribué sous forme de WASM.

  • Les outils linguistiques d’Astro, les outils d’édition requis pour le langage Astro (fichiers .astro).

  • Le theme Starlight, le theme de documentation officiel d’Astro.

  • La Feuille de route d’Astro, où l’avenir d’Astro se dessine ! Idées, suggestions et propositions formelles de RFC pour le projet Astro.

En plus de contribuer à votre propre code ou contenu, vous pouvez également apporter une contribution importante en laissant des commentaires de révision sur les PR, en ajoutant des idées ou suggestions dans les PRs et Issues GitHub existants et en participant à la maintenance des problèmes “épinglés” !

Chaque PR, en particulier les PR de traduction, a besoin de réviseurs ! En révisant les PR et en laissant des commentaires, des suggestions ou un “LGTM” (Looks Good To Me !) d’approbation. (“Looks Good To Me !”) est un excellent moyen de démarrer dans n’importe quel dépôt, et d’en apprendre plus sur Astro.

Nous avons également une communauté Discord très active ! Nous apprécions les contributions de ceux qui accueillent les nouveaux membres, répondent aux questions d’assistance et partagent ce qu’ils ont construit avec et pour Astro ! Au-delà des contributions traditionnelles sur GitHub, Astro reconnaît et soutient les membres de la communauté qui s’engagent auprès d’elle, partagent Astro dans des articles de blog, des vidéos et des conférences, et aident à maintenir la santé de notre communauté.

Nous avons plusieurs guides disponibles pour vous aider à contribuer à Astro Docs.

Qu’il s’agisse de votre toute première contribution à un logiciel libre, que vous ayez besoin d’ajouter des documents pour la nouvelle fonctionnalité d’Astro que vous venez de créer, que vous soyez un traducteur expérimenté à la recherche de la prochaine page à traduire, ou que vous souhaitiez en savoir plus sur la manière d’aider en tant que réviseur de PR… nous avons tout ce qu’il faut pour vous aider !

Visitez notre site dédié Astro Docs Docs, où vous trouverez notre documentation pour vous aider à contribuer à Astro Docs en tant que correcteur de fautes de frappe, rédacteur, traducteur, développeur de fonctionnalités, et même en tant que réviseur des relations publiques.

Voici des guides du dépôt de documentation pour des rôles spécifiques au sein de la communauté Astro.

Ces documents vous sont fournis par toutes ces personnes. Rejoignez-nous sur GitHub !