Sobre repositórios
Um repositório é o elemento mais básico do GitHub. É um lugar onde você pode armazenar seu código, seus arquivos e o histórico de revisão de cada arquivo. Os repositórios podem ter vários colaboradores e podem ser públicos ou particulares.
Para criar um novo repositório, vá para https://github.com/new. Para obter instruções, confira a Criar um repositório.
Terminologia do repositório
Antes de começar a usar repositórios, aprenda esses termos importantes.
| Termo | Definição |
|---|---|
| Branch | Uma versão paralela do código que está contida dentro do repositório, mas não afeta a ramificação primária ou principal. |
| Clone | Baixar uma cópia completa dos dados de um repositório de sua empresa, incluindo todas as versões de cada arquivo e pasta. |
| Fork | Um novo repositório que compartilha configurações de código e visibilidade com o repositório "upstream" original. |
| Mesclar | Pegar as alterações de um branch e aplicá-las à outra. |
| Solicitação de pull | Uma solicitação para mesclar as alterações de um branch em outro. |
| Remoto | Um repositório armazenado no GitHub AE, não no seu computador. |
| Upstream | O branch em um repositório original em que foi criado um fork ou clonado. O branch correspondente no branch clonado ou em que o fork foi criado é chamado de "downstream". |
Sobre propriedade do repositório
Você pode possuir repositórios individualmente ou compartilhar a propriedade de repositórios com outras pessoas em uma organização.
Em ambos os casos, o acesso aos repositórios é gerenciado por permissões. Para obter mais informações, confira "Níveis de permissão para um repositório da conta pessoal" e "Funções de repositório para uma organização."
Sobre colaboração
Você pode usar repositórios para gerenciar seu trabalho e colaborar com outras pessoas.
- Você pode usar problemas para coletar feedback do usuário, relatar erros de software e organizar tarefas que você gostaria de realizar. Para saber mais, confira "Sobre problemas".
- É possível usar pull requests para propor alterações em um repositório. Para obter mais informações, confira "Sobre solicitação de pull".
- Você pode usar quadros de projeto para organizar e priorizar seus problemas e pull requests. Para obter mais informações, confira "Sobre project boards".
Cada pessoa e organização pode ser o proprietário de repositórios ilimitados e convidar um número ilimitado de colaboradores em todos os repositórios.
Sobre a visibilidade do repositório
É possível restringir quem tem acesso a um repositório escolhendo a visibilidade de um repositório: privado ou interno.
Ao criar um repositório pertencente à sua conta pessoal, o repositório é sempre privado. Ao criar um repositório pertencente a uma organização, você pode optar por tornar o repositório privado ou interno.
- Os repositórios só podem ser acessados por você, pelas pessoas com as quais você compartilha explicitamente o acesso e, para repositórios da organização, por determinados integrantes da organização.
- Repositórios internos podem ser acessados por todos os integrantes da empresa. Para obter mais informações, confira "Sobre os repositórios internos".
Os proprietários da organização sempre têm acesso a todos os repositórios criados em uma organização. Para obter mais informações, confira "Funções de repositório para uma organização".
As pessoas com permissões de administrador para um repositório podem alterar a visibilidade de um repositório existente. Para obter mais informações, confira "Definir a visibilidade do repositório".
Sobre repositórios internos
Você pode usar repositórios internos para praticar o uso do "InnerSource" na sua empresa. Os integrantes da sua empresa podem colaborar usando metodologias de código aberto sem compartilhar informações proprietárias publicamente. Para obter mais informações sobre o InnerSource, confira o white paper "Uma introdução ao InnerSource" do GitHub.
Todos os integrantes da empresa têm permissões de leitura no repositório interno, mas os repositórios internos não são visíveis para pessoas que não são integrantes de qualquer organização, incluindo colaboradores externos em repositórios da organização. Para obter mais informações, confira "Funções em uma empresa" e "Funções de repositório para uma organização."
Membros dela podem criar fork de qualquer repositório de propriedade de uma organização na empresa. O repositório bifurcado pertencerá à conta pessoal do integrante e a visibilidade da bifurcação será privada. Se um usuário for removido de todas as organizações pertencentes à empresa, essas bifurcações do usuário dos repositórios internos do usuário serão removidas automaticamente.
Próximas etapas
Aqui estão alguns recursos úteis para as próximas etapas com repositórios.
- "Práticas recomendadas para repositórios": saiba como usar os repositórios de maneira mais eficaz.
- "Criar um repositório": crie um novo repositório.
- "Criar e excluir branches no repositório": saiba como criar e excluir branches em seu repositório.
- "Como criar uma solicitação de pull": crie uma solicitação de pull para propor e colaborar em alterações em um repositório.