hozybyzamozila
commented
4 years ago Guias de vídeo
Ajuda do GitHub

Olá Mundo
10 minutos de leitura
O projeto Hello World é uma tradição consagrada na programação de computadores. É um exercício simples que o ajuda a aprender algo novo. Vamos começar com o GitHub!
Você aprenderá como:
Crie e use um repositório
Inicie e gerencie uma nova filial
Faça alterações em um arquivo e envie-os ao GitHub como commits
Abra e mescle uma solicitação pull
O que é o GitHub?
GitHub é uma plataforma de hospedagem de código para controle de versão e colaboração. Ele permite que você e outras pessoas trabalhem juntos em projetos de qualquer lugar.
Este tutorial ensina os conceitos básicos do GitHub, como repositórios , ramificações , confirmações e solicitações de recebimento . Você criará seu próprio repositório Hello World e aprenderá o fluxo de trabalho Pull Request do GitHub, uma forma popular de criar e revisar código.
Nenhuma codificação necessária
Para concluir este tutorial, você precisa de uma conta GitHub.com e acesso à Internet. Você não precisa saber como codificar, usar a linha de comando ou instalar o Git (o software de controle de versão do GitHub é baseado).
Dica: abra este guia em uma janela (ou guia) separada do navegador para poder vê-lo enquanto você conclui as etapas do tutorial.
Etapa 1. Crie um Repositório
Um repositório geralmente é usado para organizar um único projeto. Os repositórios podem conter pastas e arquivos, imagens, vídeos, planilhas e conjuntos de dados - tudo o que seu projeto precisar. Recomendamos incluir um README ou um arquivo com informações sobre seu projeto. O GitHub facilita adicionar um ao mesmo tempo que você cria seu novo repositório. Ele também oferece outras opções comuns, como um arquivo de licença.
Seu hello-worldrepositório pode ser um lugar onde você armazena ideias, recursos ou até mesmo compartilha e discute coisas com outras pessoas.
Para criar um novo repositório
No canto superior direito, próximo ao seu avatar ou ícone de identidade, clique em e selecione Novo repositório .
Nomeie seu repositório hello-world.
Escreva uma breve descrição.
Selecione Inicializar este repositório com um README .

Clique em Criar repositório .
Etapa 2. Criar uma filial
Ramificação é a maneira de trabalhar em diferentes versões de um repositório ao mesmo tempo.
Por padrão, seu repositório tem um branch nomeado mainque é considerado o branch definitivo. Usamos branches para experimentar e fazer edições antes de enviá-los main.
Quando você cria um branch fora do mainbranch, você está fazendo uma cópia, ou instantâneo, de maincomo ele era naquele ponto no tempo. Se outra pessoa fez alterações no mainbranch enquanto você estava trabalhando em seu branch, você poderia obter essas atualizações.
Este diagrama mostra:
O mainramo
Um novo branch chamado feature(porque estamos fazendo um 'trabalho de recurso' neste branch)
A jornada que featureleva antes de se fundirmain

Você já salvou diferentes versões de um arquivo? Algo como:
story.txt
story-joe-edit.txt
story-joe-edit-reviewed.txt
Ramificações realizam objetivos semelhantes em repositórios GitHub.
Aqui no GitHub, nossos desenvolvedores, escritores e designers usam branches para manter as correções de bugs e o trabalho de recursos separados de nosso mainbranch (de produção). Quando uma mudança está pronta, eles mesclam seu branch em main.
Para criar um novo ramo
Vá para o seu novo repositório hello-world.
Clique na lista suspensa no topo da lista de arquivos que diz branch: main .
Digite um nome de readme-editsramificação,, na caixa de texto da nova ramificação.
Selecione a caixa azul Criar ramo ou pressione “Enter” no teclado.

Agora você tem dois ramos maine readme-edits. Eles parecem exatamente iguais, mas não por muito tempo! Em seguida, adicionaremos nossas alterações ao novo branch.
Etapa 3. Faça e confirme as alterações
Bravo! Agora, você está na visualização de código de seu readme-editsbranch, que é uma cópia de main. Vamos fazer algumas edições.
No GitHub, as alterações salvas são chamadas de commits . Cada confirmação tem uma mensagem de confirmação associada , que é uma descrição que explica por que uma mudança específica foi feita. Mensagens de confirmação capturam o histórico de suas alterações, para que outros colaboradores possam entender o que você fez e por quê.
Fazer e confirmar alterações
Clique no README.mdarquivo.
Clique no ícone de lápis no canto superior direito da visualização do arquivo a ser editado.
No editor, escreva um pouco sobre você.
Escreva uma mensagem de confirmação que descreva suas mudanças.
Clique no botão Confirmar alterações .

Essas alterações serão feitas apenas no arquivo README em seu readme-editsbranch, então agora este branch contém conteúdo diferente de main.
Etapa 4. Abra uma solicitação pull
Boas edições! Agora que você tem alterações em um branch de main, pode abrir uma solicitação pull .
Pull Requests are the heart of collaboration on GitHub. When you open a pull request, you’re proposing your changes and requesting that someone review and pull in your contribution and merge them into their branch. Pull requests show diffs, or differences, of the content from both branches. The changes, additions, and subtractions are shown in green and red.
As soon as you make a commit, you can open a pull request and start a discussion, even before the code is finished.
By using GitHub’s @mention system in your pull request message, you can ask for feedback from specific people or teams, whether they’re down the hall or 10 time zones away.
You can even open pull requests in your own repository and merge them yourself. It’s a great way to learn the GitHub flow before working on larger projects.
Open a Pull Request for changes to the README
Click on the image for a larger version
StepScreenshotClick the Pull Request tab, then from the Pull Request page, click the green New pull request button.In the Example Comparisons box, select the branch you made, readme-edits, to compare with main (the original).Look over your changes in the diffs on the Compare page, make sure they’re what you want to submit.When you’re satisfied that these are the changes you want to submit, click the big green Create Pull Request button.Give your pull request a title and write a brief description of your changes.
When you’re done with your message, click Create pull request!
Tip: You can use emoji and drag and drop images and gifs onto comments and Pull Requests.
Step 5. Merge your Pull Request
In this final step, it’s time to bring your changes together – merging your readme-edits branch into the main branch.
Click the green Merge pull request button to merge the changes into main.
Click Confirm merge.
Go ahead and delete the branch, since its changes have been incorporated, with the Delete branch button in the purple box.
 
Celebrate!
By completing this tutorial, you’ve learned to create a project and make a pull request on GitHub!
Here’s what you accomplished in this tutorial:
Created an open source repository
Started and managed a new branch
Changed a file and committed those changes to GitHub
Opened and merged a Pull Request
Take a look at your GitHub profile and you’ll see your new contribution squares!
To learn more about the power of Pull Requests, we recommend reading the GitHub flow Guide. You might also visit GitHub Explore and get involved in an Open Source project.
Tip: Check out our other Guides, YouTube Channel and On-Demand Training for more on how to get started with GitHub.
Última atualização em 24 de julho de 2020
O GitHub é a melhor maneira de criar e enviar software. Colaboração poderosa, revisão de código e gerenciamento de código para software livre e projetos privados.
amsm