Hello World

O projecto Hello World é uma tradição consagrada na programação de computadores. É um exercício simples que o faz começar quando se aprende algo novo. Vamos começar com GitHub!

Vais aprender como:

• Criar e usar um repositório
• Iniciar e gerir um novo ramo
• Fazer alterações num ficheiro e empurrá-las para GitHub como commits
• Abrir e fundir um pedido de puxar

O que é GitHub?

GitHub é uma plataforma de alojamento de código para controlo de versões e colaboração. Permite que você e outros trabalhem juntos em projectos de qualquer lugar.

Este tutorial ensina-lhe o essencial do GitHub, como repositórios, filiais, compromissos, e pedidos de extracção. Irá criar o seu próprio repositório Hello World e aprender o fluxo de trabalho Pull Request do GitHub, uma forma popular de criar e rever código.

Sem codificação necessária

Para completar este tutorial, precisa de uma conta GitHub.com e acesso à Internet. Não precisa de saber codificar, usar a linha de comando, ou instalar Git (o software de controlo de versão GitHub é construído sobre).

Tip: Abra este guia numa janela separada do navegador (ou separador) para que o possa ver enquanto completa os passos no tutorial.

Passo 1. Criar um Repositório

Um repositório é normalmente utilizado para organizar um único projecto. Os Repositórios podem conter pastas e ficheiros, imagens, vídeos, folhas de cálculo e conjuntos de dados – tudo o que o seu projecto precisar. Recomendamos incluir um README, ou um ficheiro com informação sobre o seu projecto. GitHub facilita a adição de um ao mesmo tempo que cria o seu novo repositório. Também oferece outras opções comuns tais como um ficheiro de licença.

Seu hello-world repositório pode ser um lugar onde guardas ideias, recursos, ou mesmo partilhar e discutir coisas com outros.

Para criar um novo repositório

1. No canto superior direito, junto ao teu avatar ou identicon, clica e depois selecciona Novo repositório.
2. Nomeia o teu repositório hello-world.
3. Escreve uma breve descrição.

li>Selecciona Inicializar este repositório com um LEIAME.



Click Create repository.

Step 2. Criar um ramo

Branching é a forma de trabalhar em diferentes versões de um repositório de uma vez.

Por defeito o seu repositório tem um ramo chamado main que é considerado como o ramo definitivo. Usamos ramos para experimentar e fazer edições antes de os submeter a main.

Quando se cria um ramo fora do ramo main, está-se a fazer uma cópia, ou instantâneo, de main como era naquele momento. Se outra pessoa fizesse alterações ao ramo main enquanto estava a trabalhar no seu ramo, poderia fazer essas actualizações.

Este diagrama mostra:

• O main ramo
• Um novo ramo chamado feature (porque estamos a fazer ‘trabalho de reportagem’ sobre este ramo)
• A viagem que feature toma antes de ser fundido em main

Deixou alguma vez guardar diferentes versões de um ficheiro? Algo como:

• story.txt
• story-joe-edit.txt
• story-joe-edit-reviewed.txt

p>Branches realizam objectivos semelhantes em repositórios GitHub.

Aqui em GitHub, os nossos criadores, escritores e designers usam ramos para manter as correcções de bugs e apresentar trabalhos separados do nosso main (produção) ramo. Quando uma mudança está pronta, fundem o seu ramo em main.

Para criar um novo ramo

1. Vá ao seu novo repositório hello-world.

>li>Clica na parte superior da lista de ficheiros que diz ramo: principal.

2. Digite o nome do ramo, readme-edits, para a nova caixa de texto do ramo.
3. Seleccione a caixa azul Criar ramo ou carregue em “Enter” no seu teclado.

Agora tem dois ramos, main e readme-edits. Têm exactamente o mesmo aspecto, mas não por muito tempo! A seguir vamos adicionar as nossas alterações ao novo ramo.

Passo 3. Fazer e cometer alterações

Bravo! Agora, está na vista de código para o seu readme-edits ramo, que é uma cópia de main. Vamos fazer algumas edições.

No GitHub, as alterações guardadas são chamadas de commits. Cada commit tem uma mensagem de commit associada, que é uma descrição que explica porque é que uma determinada alteração foi feita. As mensagens de submissão capturam o histórico das suas alterações, para que outros colaboradores possam compreender o que fez e porquê.

Faça e submeta alterações

1. Click the README.md file.
2. Click the pencil icon in the upper right corner of the file view to edit.
3. No editor, escreva um pouco sobre si mesmo.
4. Escreve uma mensagem de submissão que descreve as tuas alterações.
5. Clica no botão Commit changes.

Estas alterações serão feitas apenas ao ficheiro README no seu readme-edits ramo, por isso agora este ramo contém conteúdo diferente de main.

Step 4. Abrir um Pull Request

Nice edits! Agora que tem alterações num ramo de main, pode abrir um pedido de puxar.

P>Puxar Pedidos são o coração da colaboração no GitHub. Quando abre um pedido pull, está a propor as suas alterações e a pedir a alguém que reveja e retire a sua contribuição e as funda no seu ramo. Os pedidos pull mostram diffs, ou diferenças, do conteúdo de ambos os ramos. As alterações, adições, e subtracções são mostradas a verde e vermelho.

Assim que fizer um pedido pull, pode abrir um pedido pull e iniciar uma discussão, mesmo antes do código estar terminado.

Usando o sistema @mention do GitHub na sua mensagem de pedido pull, pode pedir feedback a pessoas ou equipas específicas, quer estejam ao fundo do corredor ou a 10 fusos horários de distância.

Pode até abrir pedidos pull no seu próprio repositório e fundi-los você mesmo. É uma óptima maneira de aprender o fluxo do GitHub antes de trabalhar em projectos maiores.

Abra um Pedido de Puxar para alterações ao README

Clique na imagem para uma versão maior

>th>Stepth>Screenshot >Discuta as suas alterações nos diffs na página Comparar, certifica-te de que são o que queres submeter.

Click o separador Pull Request, depois a partir da página Pull Request, clicar no botão verde New pull Request.
Na caixa Comparações de Exemplos, seleccione o ramo que fez, readme-edits, para comparar com main (o original).
Quando estiver satisfeito que estas são as alterações que deseja submeter, clique no grande botão verde Criar Pedido de Puxar.
Dê um título ao seu pedido de puxar e escreva uma breve descrição das suas alterações.

Quando terminar a sua mensagem, clique em Create pull request!

Tip: Pode usar emoji e arrastar e largar imagens e gifs nos comentários e Pull Requests.

Step 5. Fundir o seu Pull Request

Neste passo final, é altura de juntar as suas alterações – fundindo o seu readme-edits ramo no main ramo.

1. Clique no botão verde de pedido de fusão para fundir as alterações em main.
2. Clique em Confirmar fusão.
3. Vá em frente e apague o ramo, uma vez que as suas alterações foram incorporadas, com o botão Apagar ramo na caixa púrpura.

Celebrate!

Ao completar este tutorial, aprendeu a criar um projecto e a fazer um pedido de extracção no GitHub!

Aqui está o que conseguiu neste tutorial:

• Criou um repositório de código aberto
• Iniciou e geriu um novo ramo
• Modificou um ficheiro e submeteu essas alterações ao GitHub
• Abrir e fundiu um Pedido de Puxar

Dê uma vista de olhos ao teu perfil no GitHub e verás os teus novos quadrados de contribuição!