Esta versão do GitHub Enterprise foi descontinuada em 2021-06-09. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, melhorar a segurança e novos recursos, upgrade to the latest version of GitHub Enterprise. Para ajuda com a atualização, contact GitHub Enterprise support.

Criando arquivos padrão de integridade da comunidade

Você pode criar arquivos padrão de integridade da comunidade, como CONTRIBUTING e CODE_OF_CONDUCT. Default files will be used for any repository owned by the account that does not contain its own file of that type.

Sobre arquivos padrão de integridade da comunidade

Você pode adicionar arquivos padrão de saúde da comunidade à raiz de um repositório público denominado .github pertencente a uma organização ou conta de usuário.

GitHub Enterprise Server will use and display default files for any repository owned by the account that does not have its own file of that type in any of the following places:

  • a raiz do repositório
  • a pasta .github
  • a pasta docs

For example, anyone who creates an issue or pull request in a repository that does not have its own CONTRIBUTING file will see a link to the default CONTRIBUTING file. Se um repositório tiver arquivos na usa própria pasta .github/ISSUE_TEMPLATE, incluindo modelos de problema ou um arquivo config.yml, nenhum conteúdo da pasta padrão .github/ISSUE_TEMPLATE será usado.

Os arquivos padrão não são incluídos em clones, pacotes ou downloads de repositórios individuais, pois eles são armazenados somente no repositório .github.

Tipos de arquivo compatíveis

Você pode criar padrões na sua organização ou conta de usuário para os seguintes arquivos de saúde da comunidade:

Arquivo de integridade da comunidadeDescrição
CONTRIBUTING.mdUm arquivo CONTRIBUTING comunica como as pessoas devem contribuir com o seu projeto. Para obter mais informações, consulte "Definir diretrizes para contribuidores de repositórios".
Modelos de problemas e pull request e config.ymlOs modelos de problema e pull request personalizam e padronizam as informações que você deseja que contribuidores incluam quando eles abrem problemas e pull requests no seu repositório. Para obter mais informações, consulte "Sobre problemas e modelos de pull request.
SUPPORT.mdUm arquivo SUPPORT permite que as pessoas conheçam maneiras de obter ajudar com seu projeto. Para obter mais informações, consulte "Adicionar recursos de suporte ao projeto".

Você não pode criar um arquivo de licença padrão. Os arquivos de licença devem ser adicionados a repositórios individuais para que o arquivo seja incluído quando um projeto for clonado, empacotado ou baixado.

Criar um repositório para arquivos padrão

  1. No canto superior direito de qualquer página, use o menu suspenso e selecione Novo repositório. Menu suspenso com a opção de criar um novo repositório
  2. Use o menu suspenso Proprietário e selecione a organização ou conta de usuário para a qual você deseja criar arquivos padrão. Menu suspenso Owner (Proprietário)
  3. Digite .github como o nome para seu repositório e uma descrição opcional. Campo Create repository (Criar repositório)
  4. Certifique-se de que o status do repositório está definido como Público (um repositório-padrão para arquivos não pode ser privado). Botões de opção para selecionar status privado ou público
  5. Selecione Initialize this repository with a README (Inicializar este repositório com um README). Caixa de seleção Initialize this repository with a README (Inicializar este repositório com um README)
  6. Clique Criar repositório.
  7. No repositório, crie um dos arquivos compatíveis de integridade da comunidade. Modelos de problema e o seu arquivo de configuração deve estar em uma pasta denominada .github/ISSUE_TEMPLATE. Todos os outros arquivos compatíveis devem estar na raiz do repositório. Para obter mais informações, consulte "Criar arquivos".