You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Si vous souhaitez contribuer à la documentation ou au site Web de Kubernetes, nous serons ravis de vous aider!
13
-
Tout le monde peut contribuer, que vous soyez nouveau dans le projet ou que vous y travailliez depuis longtemps, et que vous vous identifiez vous-même en tant que développeur, utilisateur final ou quelqu'un qui ne supporte tout simplement pas les fautes de frappe.
18
+
*Kubernetes accueille les améliorations de tous les contributeurs, nouveaux et expérimentés!*
19
+
20
+
{{< note >}}
21
+
Pour en savoir plus sur comment contribuer à Kubernetes en général, consultez la
22
+
[documentation des contributeurs](https://www.kubernetes.dev/docs/).
de {{< glossary_tooltip text="CNCF" term_id="cncf" >}} sur la contribution à Kubernetes.
27
+
{{< /note >}}
28
+
29
+
---
30
+
31
+
Ce site Web est maintenu par [Kubernetes SIG Docs](/docs/contribute/#get-involved-with-sig-docs).
32
+
33
+
Contributeurs à la documentation Kubernetes:
34
+
35
+
- Améliorer le contenu existant
36
+
- Créer du nouveau contenu
37
+
- Traduire la documentation
38
+
- Gérer et publier la documentation faisant partie du cycle de mise à jour de Kubernetes
39
+
40
+
14
41
15
-
Pour vous impliquer de plusieurs façons dans la communauté Kubernetes ou d’en savoir plus sur nous, visitez le [Site de la communauté Kubernetes](/community/).
16
-
Pour plus d'informations sur le guide de style de la documentation Kubernetes, reportez-vous à la section [style guide](/docs/contribute/style/style-guide/).
17
42
18
43
<!-- body -->
19
44
20
-
## Types de contributeurs
21
-
22
-
- Un _membre_ de l'organisation Kubernetes qui a [signé le CLA](/docs/contribute/start#sign-the-cla) et contribué un peu de temps et d'efforts au projet.
23
-
Voir [Adhésion à la communauté](https://github.com/kubernetes/community/blob/master/community-membership.md) pour des critères spécifiques d'adhésion.
24
-
- Un SIG Docs _relecteur_ est un membre de l'organisation Kubernetes qui
25
-
a exprimé son intérêt pour l'examen des Pull Requests de la documentation et qui a été ajouté au groupe GitHub approprié et aux fichiers `OWNERS` dans le dépôt GitHub, par un approbateur SIG Docs.
26
-
- Un SIG Docs _approbateur_ est un membre en règle qui a démontré un engagement continu envers le projet.
27
-
Un approbateur peut fusionner des Pull Requests et publier du contenu au nom de l'organisation Kubernetes.
28
-
Les approbateurs peuvent également représenter les documents SIG dans la communauté plus large de Kubernetes.
29
-
Certaines des tâches d’un approbateur SIG Docs, telles que la coordination d’une publication, nécessitent un temps considérable.
30
-
31
-
## Façons de contribuer
32
-
33
-
Cette liste est divisée en tâches accessibles à tous, ou juste aux membres de l'organisation Kubernetes, ou encore en tâches requérant un haut niveau d'autorisation et de familiarité avec les processus SIG Docs.
34
-
Contribuer de manière constante au fil du temps peut vous aider à comprendre certaines des décisions relatives à l’outillage et à l’organisation qui ont déjà été prises.
35
-
36
-
Il ne s'agit pas d'une liste exhaustive des manières dont vous pouvez contribuer à la documentation de Kubernetes, mais cela devrait vous aider à démarrer.
37
-
38
-
-[N'importe qui](/docs/contribute/start/)
39
-
- Remplir des rapports d'anomalie reproductibles
40
-
-[Membre](/docs/contribute/start/)
41
-
- Améliorer la documentation existante
42
-
- Proposer des idées d'améliorations sur [Slack](http://slack.k8s.io/) ou sur la [liste de diffusion SIG docs](https://groups.google.com/forum/#!forum/kubernetes-sig-docs)
43
-
- Améliorer l'accessibilité de la documentation
44
-
- Fournir des commentaires non contraignants sur les PRs
45
-
- Écrire un article de blog ou une étude de cas
46
-
-[Relecteur](/docs/contribute/intermediate/)
47
-
- Documenter les nouvelles fonctionnalités
48
-
- Trier et classer les problèmes
49
-
- Relire des PRs
50
-
- Créez des diagrammes, des ressources graphiques et des vidéos / capture vidéo d'écran incorporables
51
-
- Localisation
52
-
- Contribuer à d'autres dépôts en tant que représentant de la documentation
53
-
- Éditer des chaînes pour l'utilisateur dans le code
54
-
- Améliorer les commentaires dans le code, Godoc
55
-
-[Approbateur](/docs/contribute/advanced/)
56
-
- Publier le contenu des contributeurs en approuvant et en fusionnant les PRs
57
-
- Participer à une équipe de publication de Kubernetes en tant que représentant de la documentation
58
-
- Proposer des améliorations au guide de style
59
-
- Proposer des améliorations aux tests de documentation
60
-
- Proposer des améliorations au site Web de Kubernetes ou à d'autres outils
45
+
## Démarrage
46
+
47
+
Tout le monde peut ouvrir un ticket concernant la documentation ou contribuer à une modification avec un pull request (PR) au
48
+
[répertoire de GitHub `kubernetes/website`](https://github.com/kubernetes/website).
49
+
Vous devez être à l'aise avec [git](https://git-scm.com/) et [GitHub](https://lab.github.com/)pour travailler effectivement dans la communauté Kubernetes.
50
+
51
+
Pour participer à la documentation:
52
+
53
+
1. Signez le [Contributor License Agreement (CLA)](https://github.com/kubernetes/community/blob/master/CLA.md) de CNCF.
54
+
2. Familiarisez-vous avec le [répertoire de documentation](https://github.com/kubernetes/website) et le
55
+
[générateur de site statique](https://gohugo.io) du site Web.
56
+
3. Assurez-vous de comprendre les processus de base pour
57
+
[soumettre un pull request](/docs/contribute/new-content/open-a-pr/) et
58
+
[examiner les modifications](/docs/contribute/review/reviewing-prs/).
59
+
60
+
<!-- See https://github.com/kubernetes/website/issues/28808 pour live-editor URL to this figure -->
61
+
<!-- You can also cut/paste the mermaid code into the live editor at https://mermaid-js.github.io/mermaid-live-editor to play around with it -->
62
+
63
+
{{< mermaid >}}
64
+
flowchart TB
65
+
subgraph third[Soumettre PR]
66
+
direction TB
67
+
U[] -.-
68
+
Q[Améliorer contenu] --- N[Créer contenu]
69
+
N --- O[Traduire docs]
70
+
O --- P[Gérer/publier docs faisant partie<br>du cycle de mise à jour de K8s]
71
+
72
+
end
73
+
74
+
subgraph second[Révision]
75
+
direction TB
76
+
T[ ] -.-
77
+
D[Regarder<br>le site Web et<br>répertoire de K8s] --- E[Consulter le <br>générateur de<br>site statique Hugo]
78
+
E --- F[Comprendre les commandes<br>de base de GitHub]
79
+
F --- G[Réviser PR existantes<br>et changer les<br>procès de révision]
80
+
end
81
+
82
+
subgraph first[Inscription]
83
+
direction TB
84
+
S[ ] -.-
85
+
B[Signer le<br>Contributor License<br>Agreement de CNCF] ---
86
+
C[Joindre le canal Slack<br>appelé sig-docs] --- M[Participer aux<br>réunions vidéo hebdomadaires<br>ou réunion sur Slack]
Figure 1. Premiers pas pour un nouveau contributeur.
103
+
104
+
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!
105
+
106
+
Certaines tâches nécessitent plus de confiance et plus d'accès dans l'organisation Kubernetes.
107
+
Visitez [Participer à SIG Docs](/docs/contribute/participate/) pour plus de détails sur les rôles et les autorisations.
108
+
109
+
110
+
## Votre première contribution
111
+
112
+
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.
113
+
114
+
<!-- See https://github.com/kubernetes/website/issues/28808 for live-editor URL to this figure -->
115
+
<!-- You can also cut/paste the mermaid code into the live editor at https://mermaid-js.github.io/mermaid-live-editor to play around with it -->
116
+
117
+
{{< mermaid >}}
118
+
flowchart LR
119
+
subgraph second[Première Contribution]
120
+
direction TB
121
+
S[] -.-
122
+
G[Révisez les PRs des<br>autres membres de K8s] -->
123
+
A[Vérifiez la liste de problèmes<br>de K8s/website pour <br>des bon premiers PRs] --> B[Soumettez une PR!!]
124
+
end
125
+
subgraph first[Suggested Prep]
126
+
direction TB
127
+
T[] -.-
128
+
D[Lisez l'aperçu de contribution] -->E[Lisez le contenu de K8s<br>et guide de style]
129
+
E --> F[Étudiez sur les types de contenu<br>et shortcodes de Hugo]
Figure 2. Préparation pour votre première contribution.
144
+
145
+
- Lisez [l'aperçu de la contribution](/docs/contribute/new-content/) pour en savoir plus sur les différentes façons dont vous pouvez contribuer.
146
+
- Vérifiez la [liste de problèmes `kubernetes/website`](https://github.com/kubernetes/website/issues/) pour les problèmes qui constituent de bons points d'entrée.
147
+
-[Soumettez un pull request dans GitHub](/docs/contribute/new-content/open-a-pr/#changes-using-github) sur la documentation existante et apprenez-en plus sur comment créer des tickets dans GitHub.
148
+
-[Révisez des pull requests](/docs/contribute/review/reviewing-prs/) d'autres membres de la communauté Kubernetes pour en vérifier l'exactitude et la langue.
149
+
- Lisez le [contenu](/docs/contribute/style/content-guide/) et les [guides de style](/docs/contribute/style/style-guide/)de Kubernetes afin de pouvoir laisser des commentaires éclairés.
150
+
- tudiez sur les [types de contenu de page](/docs/contribute/style/page-content-types/)
151
+
et [shortcodes](/docs/contribute/style/hugo-shortcodes/)de Hugo.
152
+
153
+
## Prochaines étapes
154
+
155
+
- Apprenez à [travailler à partir d'un clone local](/docs/contribute/new-content/open-a-pr/#fork-the-repo) du répertoire.
156
+
- Documentez [les fonctionnalités](/docs/contribute/new-content/new-features/) d'une nouvelle version.
157
+
- Participez à [SIG Docs](/docs/contribute/participate/), et devenez un
158
+
[membre ou réviseur](/docs/contribute/participate/roles-and-responsibilities/).
159
+
160
+
- Demarrez ou aidez avec une [localisation](/docs/contribute/localization/).
161
+
162
+
## S'engagez dans SIG Docs
163
+
164
+
[SIG Docs](/docs/contribute/participate/) 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.
165
+
166
+
SIG Docs communique avec différentes méthodes:
167
+
168
+
-[Joignez `#sig-docs` à l'instance Kubernetes sur Slack](https://slack.k8s.io/). Assurez-vous de vous présenter!
169
+
-[Joignez la liste de diffusion `kubernetes-sig-docs`](https://groups.google.com/forum/#!forum/kubernetes-sig-docs), où des discussions plus larges ont lieu et les décisions officielles sont enregistrées.
170
+
- Joignez la [réunion vidéo SIG Docs](https://github.com/kubernetes/community/tree/master/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](https://calendar.google.com/calendar/embed?src=cgnt364vd8s86hr2phapfjc6uk%40group.calendar.google.com&ctz=America/Los_Angeles). Vous devrez télécharger [Zoom](https://zoom.us/download) ou vous connecter à l'aide d'un téléphone.
171
+
- 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.
172
+
61
173
174
+
## Autres façons de contribuer
62
175
176
+
- Visitez le site de la [communauté Kubernetes](/community/). Participez sur Twitter ou Stack Overflow, découvrez les meetups et événements Kubernetes locaux, et davantage encore.
177
+
- Lisez le [cheatsheet de contributor](https://www.kubernetes.dev/docs/contributor-cheatsheet/) pour vous impliquer dans le développement des fonctionnalités de Kubernetes.
178
+
- Visitez le site des contributeurs pour en savoir plus sur [les contributeurs Kubernetes](https://www.kubernetes.dev/) et des [ressources supplémentaires pour les contributeurs](https://www.kubernetes.dev/resources/).
179
+
- Soumettez un article de [blog ou une étude de cas](/docs/contribute/new-content/blogs-case-studies/).
0 commit comments