Skip to content

Commit

Permalink
Add Setting up the OWNERS files section
Browse files Browse the repository at this point in the history
* Add Setting up the OWNERS files section
* Update OWNERS_ALIASES patch
  • Loading branch information
raelga committed Apr 20, 2019
1 parent a06c9c7 commit d7cea87
Showing 1 changed file with 52 additions and 0 deletions.
52 changes: 52 additions & 0 deletions content/en/docs/contribute/localization.md
Original file line number Diff line number Diff line change
Expand Up @@ -120,6 +120,58 @@ Provide guidance to localization contributors in the localized `README-**.md` fi

After you create the localized README, add a link to the file from the main English `README.md`, and include contact information in English. You can provide a GitHub ID, email address, [Slack channel](https://slack.com/), or other method of contact. You must also provide a link to your localized Community Code of Conduct.

### Setting up the OWNERS files

To set the roles of each user contributing to the localization, create an `OWNERS` file inside the language-specific subdirectory with:

- **reviewers**: A list of kubernetes teams with reviewer roles, in this case, the `sig-docs-**-reviews` team created in [Add your localization team in GitHub](#add-your-localization-team-in-github).
- **approvers**: A list of kubernetes teams with approvers roles, in this case, the `sig-docs-**-owners` team created in [Add your localization team in GitHub](#add-your-localization-team-in-github).
- **labels**: A list of GitHub labels to automatically apply to a PR, in this case, the language label created in [Configure the workflow](#configure-the-workflow).

More information about the `OWNERS` file can be found at [community/contributors/guide/owners.md](https://github.com/kubernetes/community/blob/master/contributors/guide/owners.md).

The [Spanish OWNERS file](https://github.com/kubernetes/website/blob/master/content/es/OWNERS), with language code `es`, looks like:

```yaml
# See the OWNERS docs at https://go.k8s.io/owners

# This is the localization project for Spanish.
# Teams and members are visible at https://github.com/orgs/kubernetes/teams.

reviewers:
- sig-docs-es-reviews

approvers:
- sig-docs-es-owners

labels:
- language/es
```
Once the language-specific `OWNERS` file is created, update the [root `OWNERS_ALIASES`](https://github.com/kubernetes/website/blob/master/OWNERS_ALIASES) file with the new Kubernetes teams for the localization.

For each team, add the list of GitHub users requested in [Add your localization team in GitHub](#add-your-localization-team-in-github), in alphabetical.

```diff
--- a/OWNERS_ALIASES
+++ b/OWNERS_ALIASES
@@ -48,6 +48,14 @@ aliases:
- stewart-yu
- xiangpengzhao
- zhangxiaoyu-zidif
+ sig-docs-es-owners: # Admins for Spanish content
+ - raelga
+ - alexbrand
+ sig-docs-es-reviews: # PR reviews for Spanish content
+ - raelga
+ - alexbrand
+ - glo-pena
+ - electrocucaracha
sig-docs-fr-owners: # Admins for French content
- remyleone
- perriea
```

## Translating content

Localizing *all* of the Kubernetes documentation is an enormous task. It's okay to start small and expand over time.
Expand Down

0 comments on commit d7cea87

Please sign in to comment.