fix typos and wording review
This commit is contained in:
parent
4dc14931e8
commit
2261af19a7
|
|
@ -18,11 +18,10 @@ zu laufenden Pull Requests abzugeben.
|
||||||
Du kannst dich ausserdem als [Member](/de/docs/contribute/participate/roles-and-responsibilities/#member),
|
Du kannst dich ausserdem als [Member](/de/docs/contribute/participate/roles-and-responsibilities/#member),
|
||||||
[Reviewer](/de/docs/contribute/participate/roles-and-responsibilities/#reviewer), oder
|
[Reviewer](/de/docs/contribute/participate/roles-and-responsibilities/#reviewer), oder
|
||||||
[Approver](/de/docs/contribute/participate/roles-and-responsibilities/#approver) beteiligen.
|
[Approver](/de/docs/contribute/participate/roles-and-responsibilities/#approver) beteiligen.
|
||||||
Diese Rollen erfordern einen erweiterten Zugriff und bringen bestimmte Verantwortlichkeiten für
|
Diese Rollen erfordern einen erweiterten Zugriff und bringen bestimmte Verantwortlichkeiten zur Genehmigung und Bestätigung von Änderungen mit sich.
|
||||||
Änderungen zu genehmigen und zu bestätigen.
|
|
||||||
Unter [community-membership](https://github.com/kubernetes/community/blob/master/community-membership.md) findest du weitere Informationen darüber, wie die Mitgliedschaft in der Kubernetes-Community funktioniert.
|
Unter [community-membership](https://github.com/kubernetes/community/blob/master/community-membership.md) findest du weitere Informationen darüber, wie die Mitgliedschaft in der Kubernetes-Community funktioniert.
|
||||||
|
|
||||||
Der Rest dieses Dokuments umreiß,t einige spezielle Vorgehensweisen dieser Rollen innerhalb von SIG Docs, die für die Pflege eines der öffentlichsten Aushängeschilder von Kubernetes verantwortlich ist - die Kubernetes-Website und die Dokumentation.
|
Der Rest dieses Dokuments umreißt einige spezielle Vorgehensweisen dieser Rollen innerhalb von SIG Docs, die für die Pflege eines der öffentlichsten Aushängeschilder von Kubernetes verantwortlich ist - die Kubernetes-Website und die Dokumentation.
|
||||||
|
|
||||||
<!-- body -->
|
<!-- body -->
|
||||||
## SIG Docs Vorstand
|
## SIG Docs Vorstand
|
||||||
|
|
@ -30,7 +29,7 @@ Der Rest dieses Dokuments umreiß,t einige spezielle Vorgehensweisen dieser
|
||||||
Jede SIG, auch die SIG Docs, wählt ein oder mehrere SIG-Mitglieder, die als
|
Jede SIG, auch die SIG Docs, wählt ein oder mehrere SIG-Mitglieder, die als
|
||||||
Vorstand fungieren. Sie sind die Kontaktstellen zwischen der SIG Docs und anderen Teilen der
|
Vorstand fungieren. Sie sind die Kontaktstellen zwischen der SIG Docs und anderen Teilen der
|
||||||
der Kubernetes-Organisation. Sie benötigen umfassende Kenntnisse über die Struktur
|
der Kubernetes-Organisation. Sie benötigen umfassende Kenntnisse über die Struktur
|
||||||
des Kubernetes-Projekts als Ganzes und wie SIG Docs darin arbeitet. Informationen zur [Leitung](https://github.com/kubernetes/community/tree/master/sig-docs#leadership) und den aktuellen Vorsitzenden.
|
des Kubernetes-Projekts als Ganzes und wie SIG Docs darin arbeitet. Hier findest zu alle weiteren Informationen zu den aktuellen Vorsitzenden und der [Leitung](https://github.com/kubernetes/community/tree/master/sig-docs#leadership).
|
||||||
## SIG Docs-Teams und Automatisierung
|
## SIG Docs-Teams und Automatisierung
|
||||||
|
|
||||||
Die Automatisierung in SIG Docs stützt sich auf zwei verschiedene Mechanismen:
|
Die Automatisierung in SIG Docs stützt sich auf zwei verschiedene Mechanismen:
|
||||||
|
|
@ -43,11 +42,9 @@ Es gibt zwei Kategorien von SIG Docs [Teams](https://github.com/orgs/kubernetes/
|
||||||
- `@sig-docs-{language}-owners` sind Genehmiger und Verantwortliche
|
- `@sig-docs-{language}-owners` sind Genehmiger und Verantwortliche
|
||||||
- `@sig-docs-{language}-reviewers` sind Reviewer
|
- `@sig-docs-{language}-reviewers` sind Reviewer
|
||||||
|
|
||||||
Jede Gruppe kann in GitHub-Kommentaren mit ihrem `@name` referenziert werden, um mit
|
Jede Gruppe kann in GitHub-Kommentaren mit ihrem `@name` referenziert werden, um mit allen Mitgliedern dieser Gruppe zu kommunizieren.
|
||||||
mit allen Mitgliedern dieser Gruppe zu kommunizieren.
|
|
||||||
|
|
||||||
Manchmal überschneiden sich Prow- und GitHub-Teams, ohne genau übereinzustimmen. Für
|
Manchmal überschneiden sich Prow- und GitHub-Teams, ohne eine genaue Übereinstimmung. Für die Zuordnung von Issues, Pull-Requests und zur Unterstützung von PR-Genehmigungen verwendet die
|
||||||
Zuordnung von Issues, Pull-Requests und zur Unterstützung von PR-Genehmigungen verwendet die
|
|
||||||
Automatisierung die Informationen aus den `OWNERS`-Dateien.
|
Automatisierung die Informationen aus den `OWNERS`-Dateien.
|
||||||
|
|
||||||
### OWNERS Dateien und Front-Matter
|
### OWNERS Dateien und Front-Matter
|
||||||
|
|
@ -58,7 +55,7 @@ Das [Kubernetes-Website-Repository](https://github.com/kubernetes/website) verwe
|
||||||
- blunderbuss
|
- blunderbuss
|
||||||
- approve
|
- approve
|
||||||
|
|
||||||
Diese beiden Plugins verwenden die
|
Diese beiden Plugins nutzen die
|
||||||
[OWNERS](https://github.com/kubernetes/website/blob/main/OWNERS) und
|
[OWNERS](https://github.com/kubernetes/website/blob/main/OWNERS) und
|
||||||
[OWNERS_ALIASES](https://github.com/kubernetes/website/blob/main/OWNERS_ALIASES)
|
[OWNERS_ALIASES](https://github.com/kubernetes/website/blob/main/OWNERS_ALIASES)
|
||||||
Dateien auf der obersten Ebene des GitHub-Repositorys `kubernetes/website`, um zu steuern
|
Dateien auf der obersten Ebene des GitHub-Repositorys `kubernetes/website`, um zu steuern
|
||||||
|
|
@ -66,25 +63,24 @@ wie prow innerhalb des Repositorys arbeitet.
|
||||||
|
|
||||||
Eine OWNERS-Datei enthält eine Liste von Personen, die SIG Docs-Reviewer und
|
Eine OWNERS-Datei enthält eine Liste von Personen, die SIG Docs-Reviewer und
|
||||||
Genehmiger sind. OWNERS-Dateien können auch in Unterverzeichnissen existieren und bestimmen, wer
|
Genehmiger sind. OWNERS-Dateien können auch in Unterverzeichnissen existieren und bestimmen, wer
|
||||||
Dateien in diesem Unterverzeichnis und seinen Unterverzeichnissen als Rezensent oder
|
Dateien in diesem Unterverzeichnis und seinen Unterverzeichnissen als Gutachter oder
|
||||||
Genemiger bestätigen darf. Weitere Informationen über OWNERS-Dateien im Allgemeinen findest du unter
|
Genehmiger bestätigen darf. Weitere Informationen über OWNERS-Dateien im Allgemeinen findest du unter
|
||||||
[OWNERS](https://github.com/kubernetes/community/blob/master/contributors/guide/owners.md).
|
[OWNERS](https://github.com/kubernetes/community/blob/master/contributors/guide/owners.md).
|
||||||
|
|
||||||
Auß,erdem kann eine einzelne Markdown-Datei in ihrem Front-Matter (Vorspann) Reviewer und Genehmiger auflisten.
|
Außerdem kann eine einzelne Markdown-Datei in ihrem Front-Matter (Vorspann) Reviewer und Genehmiger auflisten.
|
||||||
Entweder durch Auflistung einzelner GitHub-Benutzernamen oder GitHub-Gruppen.
|
Entweder durch Auflistung einzelner GitHub-Benutzernamen oder GitHub-Gruppen.
|
||||||
|
|
||||||
Die Kombination aus OWNERS-Dateien und Front-Matter in Markdown-Dateien bestimmt, welche Ratschläge PR-Eigentümer von automatisierten Systemen erhalten, und wen sie um eine technische und redaktionelle Überprüfung ihres PRs bitten sollen.
|
Die Kombination aus OWNERS-Dateien und Front-Matter in Markdown-Dateien bestimmt, welche Empfehlungen PR-Eigentümer von automatisierten Systemen erhalten, und wen sie um eine technische und redaktionelle Überprüfung ihres PRs bitten sollen.
|
||||||
## So funktioniert das Zusammenführen
|
## So funktioniert das Zusammenführen
|
||||||
|
|
||||||
Wenn ein Pull Request mit der Branch (Ast) zusammengeführt wird, in dem der Inhalt veröffentlicht werden soll, wird dieser Inhalt auf http://kubernetes.io veröffentlicht. Um sicherzustellen, dass die Qualität der veröffentlichten Inhalte hoch ist, beschränken wir das Zusammenführen von Pull Requests auf
|
Wenn ein Pull Request mit der Branch (Ast) zusammengeführt wird, in dem der Inhalt bereitgestellt werden soll, wird dieser Inhalt auf http://kubernetes.io veröffentlicht. Um sicherzustellen, dass die Qualität der veröffentlichten Inhalte hoch ist, beschränken wir das Zusammenführen von Pull Requests auf
|
||||||
SIG Docs Freigabeberechtigte. So funktioniert es:
|
SIG Docs Freigabeberechtigte. So funktioniert es:
|
||||||
|
|
||||||
- Wenn eine Pull-Anfrage sowohl das `lgtm`- als auch das `approve`-Label hat, kein `hold`-Label hat,
|
- Wenn eine Pull-Anfrage sowohl das `lgtm`- als auch das `approve`-Label hat, kein `hold`-Label hat,
|
||||||
und alle Tests bestanden sind, wird der Pull Request automatisch zusammengeführt.
|
und alle Tests bestanden sind, wird der Pull Request automatisch zusammengeführt.
|
||||||
- Mitglieder der Kubernetes-Organisation und SIG Docs-Genehmiger können Kommentare hinzufügen, um
|
|
||||||
Kommentare hinzufügen, um das automatische Zusammenführen eines Pull Requests zu verhindern (durch Hinzufügen eines `/hold`-Kommentars
|
|
||||||
kann ein vorheriger `/lgtm`-Kommentar zurückgehalten werden).
|
|
||||||
- Jedes Kubernetes-Mitglied kann das `lgtm`-Label hinzufügen, indem es einen `/lgtm`-Kommentar hinzufügt.
|
- Jedes Kubernetes-Mitglied kann das `lgtm`-Label hinzufügen, indem es einen `/lgtm`-Kommentar hinzufügt.
|
||||||
|
- Mitglieder der Kubernetes-Organisation und SIG Docs-Genehmiger können kommentieren, um das automatische Zusammenführen eines Pull Requests zu verhindern (durch Hinzufügen eines `/hold`-Kommentars
|
||||||
|
kann ein vorheriger `/lgtm`-Kommentar zurückgehalten werden).
|
||||||
- Nur SIG Docs-Genehmiger können einen Pull Request zusammenführen indem sie einen `/approve` Kommentar hinzufügen.
|
- Nur SIG Docs-Genehmiger können einen Pull Request zusammenführen indem sie einen `/approve` Kommentar hinzufügen.
|
||||||
Einige Genehmiger übernehmen auch weitere spezielle Rollen, wie zum Beispiel [PR Wrangler](/docs/contribute/participate/pr-wranglers/) oder [SIG Docs Vorsitzende](#sig-docs-chairperson).
|
Einige Genehmiger übernehmen auch weitere spezielle Rollen, wie zum Beispiel [PR Wrangler](/docs/contribute/participate/pr-wranglers/) oder [SIG Docs Vorsitzende](#sig-docs-chairperson).
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -33,7 +33,7 @@ Tägliche Aufgaben in einer einwöchigen Schicht als PR Wrangler:
|
||||||
|
|
||||||
Die folgenden Anfragen sind beim Wrangling hilfreich.
|
Die folgenden Anfragen sind beim Wrangling hilfreich.
|
||||||
Wenn du diese Anfragen abgearbeitet hast, ist die verbleibende Liste der zu prüfenden PRs meist klein.
|
Wenn du diese Anfragen abgearbeitet hast, ist die verbleibende Liste der zu prüfenden PRs meist klein.
|
||||||
Diese Anfragen schließen Lokalisierungs-PRs aus. Alle Anfragen beziehen sich auf den Hauptast, außer der letzten.
|
Diese Anfragen schließen Lokalisierungs-PRs aus. Alle Anfragen beziehen sich auf den `main`-Branch, außer der letzten.
|
||||||
|
|
||||||
- [Kein CLA, nicht zusammenfürbar](https://github.com/kubernetes/website/pulls?q=is%3Aopen+ist%3Apr+label%3A%22cncf-cla%3A+no%22+-label%3A%22do-not-merge%2Fwork-in-progress%22+-label%3A%22do-not-merge%2Fhold%22+label%3Alanguage%2Fen):
|
- [Kein CLA, nicht zusammenfürbar](https://github.com/kubernetes/website/pulls?q=is%3Aopen+ist%3Apr+label%3A%22cncf-cla%3A+no%22+-label%3A%22do-not-merge%2Fwork-in-progress%22+-label%3A%22do-not-merge%2Fhold%22+label%3Alanguage%2Fen):
|
||||||
Erinnere den Beitragenden daran, den CLA zu unterschreiben. Wenn sowohl der Bot als auch ein Mensch sie daran erinnert haben, schließe
|
Erinnere den Beitragenden daran, den CLA zu unterschreiben. Wenn sowohl der Bot als auch ein Mensch sie daran erinnert haben, schließe
|
||||||
|
|
@ -44,12 +44,12 @@ Diese Anfragen schließen Lokalisierungs-PRs aus. Alle Anfragen beziehen sich au
|
||||||
- [Hat LGTM, braucht die Zustimmung von Docs](https://github.com/kubernetes/website/pulls?q=is%3Aopen+is%3Apr+-label%3Ado-not-merge%2Fwork-in-progress+-label%3Ado-not-merge%2Fhold+label%3Alanguage%2Fen+label%3Algtm+):
|
- [Hat LGTM, braucht die Zustimmung von Docs](https://github.com/kubernetes/website/pulls?q=is%3Aopen+is%3Apr+-label%3Ado-not-merge%2Fwork-in-progress+-label%3Ado-not-merge%2Fhold+label%3Alanguage%2Fen+label%3Algtm+):
|
||||||
Listet PRs auf, die einen `/approve`-Kommentar benötigen, um zusammengeführt zu werden.
|
Listet PRs auf, die einen `/approve`-Kommentar benötigen, um zusammengeführt zu werden.
|
||||||
- [Quick Wins](https://github.com/kubernetes/website/pulls?utf8=%E2%9C%93&q=is%3Apr+is%3Aopen+base%3Amain+-label%3A%22do-not-merge%2Fwork-in-progress%22+-label%3A%22do-not-merge%2Fhold%22+label%3A%22cncf-cla%3A+yes%22+label%3A%22size%2FXS%22+label%3A%22language%2Fen%22): Listet PRs gegen den Hauptzweig auf, die nicht eindeutig blockiert sind. (ändere "XS" in der Größenbezeichnung, wenn du dich durch die PRs arbeitest [XS, S, M, L, XL, XXL]).
|
- [Quick Wins](https://github.com/kubernetes/website/pulls?utf8=%E2%9C%93&q=is%3Apr+is%3Aopen+base%3Amain+-label%3A%22do-not-merge%2Fwork-in-progress%22+-label%3A%22do-not-merge%2Fhold%22+label%3A%22cncf-cla%3A+yes%22+label%3A%22size%2FXS%22+label%3A%22language%2Fen%22): Listet PRs gegen den Hauptzweig auf, die nicht eindeutig blockiert sind. (ändere "XS" in der Größenbezeichnung, wenn du dich durch die PRs arbeitest [XS, S, M, L, XL, XXL]).
|
||||||
- [Nicht gegen den Hauptast](https://github.com/kubernetes/website/pulls?q=is%3Aopen+ist%3Apr+label%3Alanguage%2Fen+-base%3Amain): Wenn der PR gegen einen `dev-`Ast gerichtet ist, ist er für eine kommende Veröffentlichung. Weise diesen dem [Docs Release Manager](https://github.com/kubernetes/sig-release/tree/master/release-team#kubernetes-release-team-roles) zu: `/assign @<manager's_github-username>`. Wenn der PR gegen einen alten Ast gerichtet ist, hilf dem Autor herauszufinden, ob er auf den richtigen Ast gerichtet ist.
|
- [Nicht gegen den `main`-Branch](https://github.com/kubernetes/website/pulls?q=is%3Aopen+ist%3Apr+label%3Alanguage%2Fen+-base%3Amain): Wenn der PR gegen einen `dev-`Ast gerichtet ist, ist er für eine kommende Veröffentlichung. Weise diesen dem [Docs Release Manager](https://github.com/kubernetes/sig-release/tree/master/release-team#kubernetes-release-team-roles) zu: `/assign @<manager's_github-username>`. Wenn der PR gegen einen alten Ast gerichtet ist, hilf dem Autor herauszufinden, ob er auf den richtigen Ast gerichtet ist.
|
||||||
|
|
||||||
### Hilfreiche Prow-Befehle für Wranglers
|
### Hilfreiche Prow-Befehle für Wranglers
|
||||||
|
|
||||||
```
|
```
|
||||||
# Englisches Label hinzufuegen
|
# Englisches Label hinzufügen
|
||||||
/language en
|
/language en
|
||||||
|
|
||||||
# füge dem PR ein Squash-Label hinzu, wenn es mehr als einen Commit gibt
|
# füge dem PR ein Squash-Label hinzu, wenn es mehr als einen Commit gibt
|
||||||
|
|
@ -59,7 +59,7 @@ Diese Anfragen schließen Lokalisierungs-PRs aus. Alle Anfragen beziehen sich au
|
||||||
/retitle [WIP] <TITLE>
|
/retitle [WIP] <TITLE>
|
||||||
```
|
```
|
||||||
|
|
||||||
### Wann Pull Requests schließen
|
### Wann sind Pull Requests zu schließen
|
||||||
|
|
||||||
Reviews und Genehmigungen sind ein Mittel, um unsere PR-Warteschlange kurz und aktuell zu halten. Ein weiteres Mittel ist das Schließen.
|
Reviews und Genehmigungen sind ein Mittel, um unsere PR-Warteschlange kurz und aktuell zu halten. Ein weiteres Mittel ist das Schließen.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -98,12 +98,12 @@ Du kannst ein Mitglied werden, nachdem du mindestens 5 substantielle Pull Reques
|
||||||
|
|
||||||
## Reviewer
|
## Reviewer
|
||||||
|
|
||||||
Reviewer (Rezensenten) sind dafür verantwortlich, offene Pull Requests zu überprüfen. Anders als bei den Mitgliedern
|
Reviewer (Gutachteren) sind dafür verantwortlich, offene Pull Requests zu überprüfen. Anders als bei den Mitgliedern
|
||||||
musst du auf das Feedback der Prüfer eingehen. Reviewer sind Mitglieder des
|
musst du auf das Feedback der Prüfer eingehen. Reviewer sind Mitglieder des
|
||||||
[@kubernetes/sig-docs-{language}-reviews](https://github.com/orgs/kubernetes/teams?query=sig-docs)
|
[@kubernetes/sig-docs-{language}-reviews](https://github.com/orgs/kubernetes/teams?query=sig-docs)
|
||||||
GitHub-Teams.
|
GitHub-Teams.
|
||||||
|
|
||||||
Rezensenten können:
|
Gutachteren können:
|
||||||
|
|
||||||
- Alles tun, was unter [Jeder](#jeder) und [Member](#member) aufgeführt ist
|
- Alles tun, was unter [Jeder](#jeder) und [Member](#member) aufgeführt ist
|
||||||
- Pull Requests überprüfen und verbindliches Feedback geben
|
- Pull Requests überprüfen und verbindliches Feedback geben
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue