Edição de uma única página usando um navegador da Web

É possível editar com facilidade uma única página no Guia do usuário do EKS diretamente por meio do seu navegador da Web.

Se você deseja editar diversas páginas usando o navegador da Web, consulte Edição de diversos arquivos usando um navegador da Web com o editor baseado na Web do GitHub.

Pré-requisitos

• Página de documentação para alterações aberta no navegador da web.

• Sessão iniciada no GitHub.

Procedimento

1. Acesse a página que deseja editar no Guia do usuário do Amazon EKS.

2. No painel direito, escolha o link Editar esta página no GitHub.

3. No GitHub, abra o editor de uma das seguintes maneiras:

   • Pressionando a tecla e no seu teclado.

   • Clicando no ícone de lápis e selecionando Editar no local no menu suspenso.

   • Caso não tenha a opção de editar, será necessário fazer login no GitHub. Sua conta do GitHub não precisa de nenhuma permissão especial para sugerir alterações. No entanto, os colaboradores internos da Amazon devem vincular seus perfis do GitHub.

4. Realize as alterações necessárias no conteúdo no editor do GitHub.

   • O editor oferece funcionalidades de destaque de sintaxe e de pré-visualização.

   • É possível usar a marcação do AsciiDoc para formatar suas alterações.

   • Você pode usar ctrl-f para abrir uma interface de localização/substituição.

5. (Opcional) Visualize previamente suas alterações.

   • Use a guia preview para visualizar previamente suas alterações com formatação avançada.

   • Use a opção show diff para destacar as seções alteradas. As seções removidas têm um indicador em vermelho na margem esquerda. As novas seções têm um indicador em verde na margem esquerda.

6. Ao concluir a edição, clique no botão Confirmar alterações... na parte superior do editor

7. Na caixa de diálogo de confirmação:

   • Verifique se seu endereço de e-mail está correto.

   • Adicione uma breve mensagem de confirmação, mas descritiva, sobre as alterações.

   • Opcionalmente, adicione uma descrição mais longa, se necessário.

   • Selecione a opção para criar uma nova ramificação e solicitação pull.

Você criou uma solicitação pull incluindo as alterações propostas.

Visão geral da solicitação pull

Quando você cria uma solicitação pull:

• As alterações são enviadas para análise dos responsáveis pelo repositório.

• Os revisores podem fazer comentários sobre suas alterações e solicitar modificações.

• Testes automatizados podem ser executados para validar suas alterações.

• Após a aprovação, suas alterações podem ser integradas ao repositório principal.

As solicitações pull ajudam a garantir a qualidade e fornecem uma maneira de debater as alterações antes de elas serem integradas.

Aprenda como as solicitações pull são analisadas e aprovadas na documentação do GitHub.