Information in this document may be out of date
This document has an older update date than the original, so the information it contains may be out of date. If you're able to read English, see the English version for the most up-to-date information: Contribute to K8s docs
Kubernetes accueille les améliorations de tous les contributeurs, nouveaux et expérimentés!
Pour en savoir plus sur comment contribuer à Kubernetes en général, consultez la documentation des contributeurs.
Vous pouvez également lire la page de CNCF sur la contribution à Kubernetes.
Ce site Web est maintenu par Kubernetes SIG Docs.
Contributeurs à la documentation Kubernetes:
- Améliorer le contenu existant
- Créer du nouveau contenu
- Traduire la documentation
- Gérer et publier la documentation faisant partie du cycle de mise à jour de Kubernetes
Démarrage
Tout le monde peut ouvrir un ticket concernant la documentation ou contribuer à une modification avec une pull request (PR) au
répertoire de GitHub kubernetes/website
.
Vous devez être à l'aise avec git et GitHub pour travailler effectivement dans la communauté Kubernetes.
Pour participer à la documentation:
- Signez le Contributor License Agreement (CLA) du CNCF.
- Familiarisez-vous avec le répertoire de documentation et le générateur de site statique du site Web.
- Assurez-vous de comprendre les processus de base pour soumettre un pull request et examiner les modifications.
Figure 1. Premiers pas pour un nouveau contributeur.
La figure 1 présente une feuille de route pour les nouveaux contributeurs. Vous pouvez suivre certaines ou toutes les étapes pour Inscription
et Révision
. Vous êtes maintenant prêt à soumettre des PRs qui atteignent vos objectifs de contribution, dont certains listés sous Soumettre PR
. Encore une fois, les questions sont toujours les bienvenues !
Certaines tâches nécessitent plus de confiance et plus d'accès dans l'organisation Kubernetes. Visitez Participer à SIG Docs pour plus de détails sur les rôles et les autorisations.
Votre première contribution
Vous pouvez préparer votre première contribution en révisant à l'avance plusieurs étapes. La figure 2 décrit les étapes et les détails suivent.
Figure 2. Préparation pour votre première contribution.
- Lisez l'aperçu de la contribution pour en savoir plus sur les différentes façons dont vous pouvez contribuer.
- Vérifiez la liste de problèmes
kubernetes/website
pour les problèmes qui constituent de bons points d'entrée. - Soumettez un pull request dans GitHub sur la documentation existante et apprenez-en plus sur comment créer des tickets dans GitHub.
- Révisez des pull requests d'autres membres de la communauté Kubernetes pour en vérifier l'exactitude et la langue.
- Lisez le contenu et les guides de stylede Kubernetes afin de pouvoir laisser des commentaires éclairés.
- Étudiez sur les types de contenu de page et shortcodesde Hugo.
Prochaines étapes
-
Apprenez à travailler à partir d'un clone local du répertoire.
-
Documentez les fonctionnalités d'une nouvelle version.
-
Participez à SIG Docs, et devenez un membre ou réviseur.
-
Demarrez ou aidez avec une localisation.
Engagez-vous dans SIG Docs
SIG Docs est le groupe de contributeurs qui publient et maintiennent la documentation Kubernetes et le site Web. S'impliquer dans SIG Docs est un excellent moyen pour les contributeurs Kubernetes (développement de fonctionnalités ou autre) d'avoir un impact important sur le projet Kubernetes.
SIG Docs communique avec différentes méthodes:
- Joignez
#sig-docs
à l'instance Kubernetes sur Slack. Assurez-vous de vous présenter! - Joignez la liste de diffusion
kubernetes-sig-docs
, où des discussions plus larges ont lieu et les décisions officielles sont enregistrées. - Joignez la réunion vidéo SIG Docs qui a lieu toutes les deux semaines. Les réunions sont toujours annoncées sur
#sig-docs
et ajoutées au calendrier des réunions de la communauté Kubernetes. Vous devrez télécharger Zoom ou vous connecter à l'aide d'un téléphone. - Joignez la réunion stand-up de SIG Docs sur Slack (async) les semaines où la réunion vidéo Zoom en personne n'a pas lieu. Les rendez-vous sont toujours annoncés sur
#sig-docs
. Vous pouvez contribuer à l'un des fils de discussion jusqu'à 24 heures après l'annonce de la réunion.
Autres façons de contribuer
- Visitez le site de la communauté Kubernetes. Participez sur Twitter ou Stack Overflow, découvrez les meetups et événements Kubernetes locaux, et davantage encore.
- Lisez le cheatsheet de contributor pour vous impliquer dans le développement des fonctionnalités de Kubernetes.
- Visitez le site des contributeurs pour en savoir plus sur les contributeurs Kubernetes et des ressources supplémentaires pour les contributeurs.
- Soumettez un article de blog ou une étude de cas.