From ed5dc4692d6b7c8e2a9bdea75a762cd462f167c5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=82ngela=20Legey?= <angelalegey@gmail.com> Date: Fri, 30 Oct 2015 16:13:39 -0200 Subject: [PATCH] =?UTF-8?q?Adiciona=20configura=C3=A7=C3=A3o=20inicial=20d?= =?UTF-8?q?o=20reposit=C3=B3rio?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- cp_07.Rmd | 25 +++++++++++++++++++++++-- cp_07.md | 23 +++++++++++++++++++++++ 2 files changed, 46 insertions(+), 2 deletions(-) diff --git a/cp_07.Rmd b/cp_07.Rmd index 3835f6e..e27031e 100644 --- a/cp_07.Rmd +++ b/cp_07.Rmd @@ -38,8 +38,29 @@ usuário pode ter um nÃvel de acesso diferente: **Guest**, **Reporter**, permissões</a> é possÃvel visualizar as habilidades concedidas para cada nÃvel. - - +Logo após criar um novo repositório, é recomendável que se crie um arquivo +`README.md`. Independente da forma como o repositório foi configurado, +é sempre fundamental que ele contenha o arquivo `README.md`. +Este arquivo é sempre o primeiro a ser mostrado na página inicial +de todo repositório. Por esse motivo, é importante que o `README.md` +contenha no mÃnimo: + +- Uma descrição geral do projeto; +- Os nomes dos autores do projeto; +- Instruções de instalação, no caso de softwares; +- A licença do projeto (especialmente para projetos públicos), ou uma +orientação sobre o uso do projeto (permissão, citação, ...). +Opcionalmente pode-se criar um arquivo *LICENSE* com a licença. +Esse arquivo ficará disponÃvel também em uma aba na página inicial do +projeto. +- (**Opcional**): um guia de contribuição, se o projeto pretende que +colaboradores externos colaborem e precisam de algumas orientações básicas +sobre como colaborar. Criando um arquivo `CONTRIBUTING.md` com este guia, +ele será automaticamente colocado em uma aba na página inicial do projeto. +- (**Opcional**) um *changelog* para que sejam registradas as modificações +realizadas entre uma versão e outra (principalmente para softwares). +Criando esse arquivo com estas informações, ele aparecerá automaticamente +em uma aba na página inicial do projeto. - *Repositórios: nÃveis de acesso, adicionar colaboradores, configuração inicial do repositório* diff --git a/cp_07.md b/cp_07.md index ff6d7a5..f45dd61 100644 --- a/cp_07.md +++ b/cp_07.md @@ -33,6 +33,29 @@ usuário pode ter um nÃvel de acesso diferente: **Guest**, **Reporter**, permissões</a> é possÃvel visualizar as habilidades concedidas para cada nÃvel. +Logo após criar um novo repositório, é recomendável que se crie um arquivo +`README.md`. Independente da forma como o repositório foi configurado, +é sempre fundamental que ele contenha o arquivo `README.md`. +Este arquivo é sempre o primeiro a ser mostrado na página inicial +de todo repositório. Por esse motivo, é importante que o `README.md` +contenha no mÃnimo: + +- Uma descrição geral do projeto; +- Os nomes dos autores do projeto; +- Instruções de instalação, no caso de softwares; +- A licença do projeto (especialmente para projetos públicos), ou uma +orientação sobre o uso do projeto (permissão, citação, ...). +Opcionalmente pode-se criar um arquivo *LICENSE* com a licença. +Esse arquivo ficará disponÃvel também em uma aba na página inicial do +projeto. +- (**Opcional**): um guia de contribuição, se o projeto pretende que +colaboradores externos colaborem e precisam de algumas orientações básicas +sobre como colaborar. Criando um arquivo `CONTRIBUTING.md` com este guia, +ele será automaticamente colocado em uma aba na página inicial do projeto. +- (**Opcional**) um *changelog* para que sejam registradas as modificações +realizadas entre uma versão e outra (principalmente para softwares). +Criando esse arquivo com estas informações, ele aparecerá automaticamente +em uma aba na página inicial do projeto. - *Repositórios: nÃveis de acesso, adicionar colaboradores, configuração inicial do repositório* -- GitLab