Exercício - Contribua para um artigo da documentação do Microsoft Learn

  • 4 minutos

Vamos praticar o fluxo de trabalho de contribuição. Neste exercício, você faz uma pequena alteração em um artigo de documentação de código aberto no Microsoft Learn. Em seguida, você propõe suas alterações abrindo uma solicitação pull.

Editar o artigo

  1. Faça login na sua conta do GitHub.

  2. Em uma guia do navegador, navegue até learn.microsoft.com/contribute/content.

  3. Na parte superior do artigo, selecione o ícone Editar lápis.

    Captura de tela do artigo do Contribute aberta e o ícone Editar lápis realçado.

  4. Selecione o ícone de lápis para bifurcar este repositório e editar na sua bifurcação ou Editar este arquivo na bifurcação deste projeto.

    Captura de tela do arquivo de origem do artigo do Contribute aberto em um navegador e o ícone Editar realçado.

  5. Se o GitHub solicitar que você bifurque o repositório na próxima página, selecione Fork the repository.

  6. O painel Editar arquivo é aberto. Você precisa adicionar uma nova frase ao início deste artigo. No início do segundo parágrafo, adicione a seguinte frase: O Microsoft Learn hospeda toda a documentação de produtos e tecnologias da Microsoft.

    Captura de tela do arquivo do Contribute editado com uma nova frase e o botão Confirmar alterações realçado.

Abra um PR

  1. Visualize suas alterações selecionando a guia Visualizar .

  2. Depois que as alterações forem finalizadas, localize e selecione Confirmar alterações.

  3. No campo Mensagem de confirmação, digite "TEST contribution".

    Captura de tela do campo Mensagem de confirmação preenchido com a contribuição TEST.

  4. Selecione Propor alterações.

  5. Na página Comparando alterações, verifique se a base diz main. Isso significa que suas alterações serão puxadas para a ramificação principal no repositório ativo.

    Captura de tela da página para verificar se a Base é Principal, o que significa que as alterações serão mescladas na ramificação principal.

    Nota

    Se não vir as base repository opções e head repository nesta página, selecione comparar entre bifurcações. Isso exibe as opções de comparação necessárias para esta etapa.

  6. Selecione o botão Criar pull request .

  7. Isso leva você para a página Abrir uma solicitação pull, onde você pode visualizar seu PR.

  8. Confirme seu PR e selecione Create pull request para abrir o PR.

    Screenshot do PR aberto.

Nota

Como este é um exercício prático, suas alterações não serão mescladas ao site ao vivo.

Parabéns pela criação do seu PR! Ainda não foi enviado, mas você concluiu o primeiro grande passo para contribuir. Deixe o separador PR aberto no seu browser. Você volta a ele no próximo exercício.