|
|
|
# Git
|
|
|
|
Este repositório foi criado para ensinar o básico de Git e Gitlab.
|
|
|
|
## Navegação rápida:
|
|
|
|
|Git|GitLab|[Treine o Git](treine/treine)|
|
|
|
|
|---|------|--------------------------------------|
|
|
|
|
|[1. Git](git/git) |[1. GitLab](gitlab/gitlab) |[1. Fork este repositório](treine/treine#1-fork-este-reposit-rio)|
|
|
|
|
|[2. Repositórios](git/repositorios) |[2. Dashboard](gitlab/dashboard) |[2. Clone o repositório](treine/treine#2-clone-o-reposit-rio)|
|
|
|
|
|[3. Fluxo de Trabalho e Arquivos](git/arquivos)|[3. Projetos](gitlab/projetos) |[3. Arrume a bagunça](treine/treine#3-arrume-a-bagun-a)|
|
|
|
|
|[4. Branches](git/branches) |[4. Commits, Diffs e Comentários](gitlab/commits)|[4. Commit!](treine/treine#4-commit)|
|
|
|
|
|[5. Merges](git/merges) |[5. Merge Request](gitlab/mergeRequest) |[5. Adicione uma licença de uso](treine/treine#5-adicione-uma-licen-a-de-uso)|
|
|
|
|
|[6. Tags](git/tags) |[6. Issues e Milestones](gitlab/issues) |[6. Upgrade!](treine/treine#6-upgrade)|
|
|
|
|
| |[7. Wiki e Snippets](gitlab/wiki) |[7. Saiu uma nova versão](treine/treine#7-saiu-uma-nova-vers-o)|
|
|
|
|
| |[8. Configure o GitLab](gitlab/configure) |[8. Que tipo de projeto é esse?](treine/treine#8-que-tipo-de-projeto-esse)|
|
|
|
|
| | |[9. Mais um merge](treine/treine#9-mais-um-merge)|
|
|
|
|
## Algum problema ou algo faltando?
|
|
|
|
Sinta-se a vontade para editar esta wiki para torná-la mais completa.
|
|
|
|
|
|
|
|
## Já sei tudo. E agora?
|
|
|
|
Então veja umas boas práticas:
|
|
|
|
* Sempre adicione um README ao seu projeto.
|
|
|
|
* Descreva o seu projeto e para que serve.
|
|
|
|
* Coloque instruções de como usá-lo e algumas informações importantes também.
|
|
|
|
* Seu projeto é público? Coloque um arquivo de licença.
|
|
|
|
* Um arquivo de licença diz para as pessoas se elas podem ou não utilizar o seu projeto e como elas podem utilizá-lo. Um projeto *open source* sem um arquivo de licença é praticamente inútil.
|
|
|
|
* Escreva mensagens significativas de commit. Não tenha medo de mencionar pessoas, issues ou milestones.
|
|
|
|
* Nomeie seus branches de acordo com o que você vai mexer
|
|
|
|
* Vai corrigir um erro? Nomeie como "Bugfix #123" (sendo #123 uma menção a uma issue)
|
|
|
|
* Vai implementar algo novo?
|
|
|
|
* Dê o nome da nova funcionalidade: "clique-mágico", "login", "nova-janela"
|
|
|
|
* Acrescente o milestone (se houver um): "clique-mágico #321"
|
|
|
|
* Coloque a versão seguida da nova funcionalidade: "v3.3.6.1-nova-janela"
|
|
|
|
* Dê nomes siginificativos para títulos de issues e milestones. E não se esqueça de escrever os detalhes no corpo da mensagem.
|
|
|
|
* Adicione comentários em commits. Pergunte porque a pessoa usou aquele método ou o que aquilo significa.
|
|
|
|
* **SEMPRE** *SEMPRE* documente o seu código. A wiki está aí para isso. Por mais bem escrito que esteja, ninguém é obrigado a entender o código que você fez.
|
|
|
|
|
|
|
|
---
|
|
|
|
#### Próximo: [Git](git/git) |
|
|
|
\ No newline at end of file |
