Categories: Tecnologia

Como (e por que) criar um repositório GitHub

Esteja você iniciando um projeto de software completamente novo ou desejando adotar uma abordagem “ Docs as Code ” com sua documentação no GitHub, uma das primeiras etapas é criar um repositório (repo). Veja como isso é feito.

Por que criar um repositório GitHub?

Git é um sistema de controle de revisão distribuído de código-fonte aberto que permite que vários desenvolvedores ( e escritores !) Façam e rastreiem constantes e consecutivamente alterações no código ou na documentação em um local centralizado sem substituir o trabalho de outra pessoa. Este controle de versão faz com que, se algo quebrar, você possa facilmente localizar a origem do problema e reverter para uma versão de trabalho antes que o código problemático seja enviado.

Também é bom para rastrear quem contribuiu com o quê e quando. Isso é especialmente importante quando várias pessoas de fusos horários diferentes estão contribuindo para um projeto.

Ao criar um repositório GitHub, você traz esses benefícios para o seu projeto. Além disso, se você permitir que seu repo seja aberto ao público, outros podem contribuir – seja isso envolvendo consertar código quebrado ou até mesmo fazer correções em erros de digitação. Você pode até conseguir lançar uma versão beta funcional antes do previsto. O código aberto é uma coisa linda.

Como criar um repositório GitHub

Para configurar um projeto no GitHub, você precisará criar um repo. Para fazer isso, faça login (ou crie ) sua conta GitHub. Uma vez logado, clique no ícone “+” no lado direito do menu do cabeçalho (que pode ser acessado de qualquer lugar do site). Selecione “Novo Repositório” no menu suspenso que aparece.

Agora você estará na página “Criar um Novo Repositório”. Escolha o proprietário do repo e dê a ele um nome curto e fácil de lembrar. Lembre-se de que o nome do repo deve ser compatível com URL. Embora não haja uma convenção estrita, a maneira mais popular é usar todas as letras minúsculas enquanto separa as palavras com um hífen, como example-repo-name. Se você usar espaços no nome, um hífen será adicionado em seu lugar.

Depois de nomear seu repo, forneça uma breve descrição e escolha se deseja torná-lo público ou privado.

Em seguida, você pode:

  • Adicionar um arquivo README : apresente e explique como usar e contribuir com seu projeto.
  • Adicionar .gitignore : Escolha quais arquivos ignorar.
  • Escolha uma licença : deixe que outras pessoas saibam o que podem ou não fazer com o código do seu projeto.

Estes são opcionais, mas altamente recomendados para adicionar. Quando estiver pronto, clique em “Criar Repositório”.

Seu repo foi criado.


Depois de criar um repo, você pode cloná-lo em sua máquina local , o que permite fazer edições no conteúdo localmente, em vez de diretamente nos arquivos de origem do repo.

maisroot

Recent Posts

O novo aplicativo “PC Manager” da Microsoft se parece muito com o CCleaner

Muitos aplicativos de limpeza estão disponíveis para Windows ao longo dos anos, mas hoje em…

1 ano ago

Como reiniciar um PS4

Seu PlayStation 4 está congelado? Seus jogos favoritos continuam travando? Reiniciar seu PS4 pode resolver…

1 ano ago

Veja por que as reticências são tão assustadoras ao enviar mensagens de texto…

A popularidade das mensagens de texto significou aprender uma forma totalmente nova de comunicação. Você…

1 ano ago

O telescópio James Webb acaba de capturar os “Pilares da Criação”

A foto dos "Pilares da Criação" tirada pelo Telescópio Espacial Hubble é uma das fotos…

1 ano ago

Você poderá baixar o Proton Drive mais cedo do que pensa

O Proton Drive saiu de seu estágio beta há algumas semanas, mas o aplicativo real…

1 ano ago

Como aumentar o zoom no Photoshop

Para ver suas fotos mais de perto ou para uma edição precisa , você pode…

1 ano ago