Exercício: Contribua com um artigo de documentação do Microsoft Learn

  • 4 minutos

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

Editar o artigo

  1. Entre em 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 de lápis Editar.

    Captura de tela do artigo para Contribuição aberto com o ícone de Edição em forma de lápis realçado.

  4. Selecione o ícone de lápis para Criar fork deste repositório e editar em seu fork ou Editar este arquivo em seu fork deste projeto.

    Captura de tela do arquivo fonte do artigo para Contribuição aberto em um navegador com o ícone de Edição realçado.

  5. Se o GitHub solicitar que você crie um fork do repositório na próxima página, selecione Criar fork do repositório.

  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 para Contribuição editado com uma nova frase e o botão Confirmar alterações realçado.

Abrir uma PR

  1. Visualize suas alterações selecionando a guia Visualização.

  2. Depois que suas alterações forem finalizadas, localize e selecione Fazer commit de alterações.

  3. No campo Mensagem de commit, digite "Contribuição TESTE".

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

  4. Selecione Propor alterações.

  5. Na página Comparar alterações, verifique se a base diz main. Isso significa que será efetuado pull de suas alterações para a ramificação principal no repositório dinâmico.

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

    Observação

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

  6. Selecione o botão Criar pull request.

  7. Isso levará você para a página Abrir um pull request, na qual você poderá visualizar seu PR.

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

    Captura de tela da PR aberta.

Observação

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

Parabéns por criar seu PR! Ele ainda não foi enviado, mas você terminou a primeira etapa importante da contribuição. Deixe a guia do PR aberta no navegador. Você voltará a ele no próximo exercício.