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

  • 4 minutos

Vamos praticar o processo 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

  4. Selecione o ícone de lápis para Fazer fork deste repositório e editar em seu fork ou Editar este arquivo no seu fork do 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 Confirmar as alterações.

  3. No campo Commit message, digite "TEST contribution".

    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 suas alterações serão incorporadas à 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 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.