Skip to main content

Sobre repositórios

Um repositório contém todos os seus códigos, arquivos e o histórico de revisão de cada arquivo. Você pode discutir e gerenciar o seu trabalho dentro do repositório.

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 Início rápido para repositórios.

Terminologia do repositório

Antes de começar a usar repositórios, aprenda esses termos importantes.

TermoDefinição
BranchUma versão paralela do código que está contida dentro do repositório, mas não afeta a ramificação primária ou principal.
CloneBaixar uma cópia completa dos dados de um repositório de GitHub.com, incluindo todas as versões de cada arquivo e pasta.
ForkUm novo repositório que compartilha configurações de código e visibilidade com o repositório "upstream" original.
MesclarPegar as alterações de um branch e aplicá-las à outra.
Solicitação de pullUma solicitação para mesclar as alterações de um branch em outro.
RemotoUm repositório armazenado no GitHub, não no seu computador.
UpstreamO 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 issues".
  • Use o GitHub Discussions para fazer perguntas e responder a elas, compartilhar informações, fazer comunicados e conduzir uma conversa sobre um projeto ou participar dela. Para obter mais informações, confira "Sobre discussões".
  • É 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 Projects para organizar e priorizar seus problemas e pull requests. Para obter mais informações, confira "Sobre Projects".

Com o GitHub Free para contas pessoais e de organizações, você pode trabalhar com colaboradores ilimitados em repositórios públicos ilimitados, com um conjunto completo de recursos, ou em repositórios privados ilimitados, com um conjunto limitado de recursos. Para obter ferramentas avançadas para repositórios privados, você pode fazer o upgrade para GitHub Pro, GitHub Team ou GitHub Enterprise Cloud. Para mais informações, confira "Planos do GitHub".

Sobre a visibilidade do repositório

É possível restringir quem tem acesso a um repositório escolhendo a visibilidade de um repositório: público ou privado.

Ao criar um repositório, você pode optar por tornar o repositório público ou privado. Os repositórios em organizações que usam GitHub Enterprise Cloud e são propriedade de uma conta corporativa também podem ser criados com visibilidade interna. Para obter mais informações, confira a documentação do GitHub Enterprise Cloud.

  • Os repositórios públicos são acessíveis a todos na Internet.
  • 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.

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".

Próximas etapas

Aqui estão alguns recursos úteis para as próximas etapas com repositórios.