O SIG Docs é um dos grupos de interesse especiais dentro do projeto Kubernetes, com foco em escrever, atualizar e manter a documentação do Kubernetes como um todo. Consulte o SIG Docs no repositório de comunidade do GitHub para obter mais informações sobre o SIG.
O SIG Docs recebe contribuições de conteúdo e revisões de todos os colaboradores. Qualquer pessoa pode abrir um pull request (PR), e qualquer pessoa é bem-vinda para registrar issues sobre conteúdo ou comentar em pull requests em andamento.
Você também pode se tornar um membro, revisor ou aprovador. Essas funções exigem maior acesso e implicam certas responsabilidades para aprovar e confirmar alterações. Consulte community-membership para obter mais informações sobre como funciona a participação na comunidade Kubernetes.
O restante deste documento descreve algumas formas específicas pelas quais essas funções operam no SIG Docs, que é responsável por manter um dos aspectos mais públicos do Kubernetes — o site e a documentação do Kubernetes.
Cada SIG, incluindo o SIG Docs, seleciona um ou mais membros para atuar como presidentes. Eles são pontos de contato entre o SIG Docs e outras partes da organização Kubernetes. Eles exigem amplo conhecimento da estrutura do projeto Kubernetes como um todo e de como o SIG Docs funciona dentro dele. Consulte Liderança para obter a lista atual de presidentes.
A automação no SIG Docs depende de dois mecanismos diferentes: equipes do GitHub e arquivos OWNERS.
Existem duas categorias de equipes do SIG Docs no GitHub:
@sig-docs-{language}-owners são aprovadores e líderes@sig-docs-{language}-reviews são revisoresCada uma pode ser mencionada com seu @nome em comentários do GitHub para se comunicar
com todos no grupo.
Às vezes, o Prow e as equipes do GitHub se sobrepõem sem correspondência exata. Para
atribuição de issues, pull requests e suporte a aprovações de PR, a automação usa
informações dos arquivos OWNERS.
O projeto Kubernetes usa uma ferramenta de automação chamada prow para automação relacionada a issues e pull requests do GitHub. O repositório do site do Kubernetes utiliza dois plugins do prow:
Esses dois plugins utilizam os arquivos
OWNERS e
OWNERS_ALIASES
no nível raiz do repositório kubernetes/website no GitHub para controlar
como o prow funciona dentro do repositório.
Um arquivo OWNERS contém uma lista de pessoas que são revisores e aprovadores do SIG Docs. Arquivos OWNERS também podem existir em subdiretórios e podem sobrescrever quem pode atuar como revisor ou aprovador de arquivos naquele subdiretório e seus descendentes. Para mais informações sobre arquivos OWNERS em geral, consulte OWNERS.
Além disso, um arquivo Markdown individual pode listar revisores e aprovadores em seu front-matter, seja por meio de nomes de usuário individuais do GitHub ou grupos do GitHub.
A combinação de arquivos OWNERS e front-matter em arquivos Markdown determina as sugestões que os autores de PR recebem dos sistemas automatizados sobre a quem solicitar revisão técnica e editorial de seu PR.
Quando um pull request é incorporado ao branch usado para publicar conteúdo, esse conteúdo é publicado em https://kubernetes.io. Para garantir a qualidade do conteúdo publicado, limitamos o merge de pull requests aos aprovadores do SIG Docs. Veja como funciona:
lgtm e approve, não tem labels hold
e todos os testes estão passando, o pull request é incorporado automaticamente./hold ou retendo um comentário /lgtm).lgtm adicionando um comentário /lgtm./approve. Alguns aprovadores também desempenham funções
adicionais específicas, como
PR Wrangler ou
presidente do SIG Docs.Para mais informações sobre como contribuir com a documentação do Kubernetes, consulte: