Templates ReadMe para repositórios no Github!

por que eu criei esses templates?

Até um tempo atrás não tinha a mínima ideia do que colocar no ReadMe dos meus repositórios. Após algumas pesquisas, criei um repositório com dois templates para facilitar a estruturação e apresentação de repositórios de projetos e estudos no GitHub.

Criar um repositório bem organizado foi o meio de explicar detalhadamente os objetivos de projetos/estudos e mostrar as ferramentas que utilizei durante o processo de codificação.

qual o objetivo desse repositório?

Desde a visão geral até as instruções para instalação, cada seção foi pensada para fornecer informações de forma organizada e acessível. O objetivo aqui é explicar o que foi feito no repositório e não deixá-lo como se fosse apenas arquivos de códigos que ninguém sabe o que é ou pra que foi feito.

Se você prefere uma abordagem mais seccionada, os templates possuem um sumário que mostra divisões do projeto, permitindo um detalhamento de cada parte, desde a configuração até as funcionalidades principais, versões responsivas de layouts, meios de instalações e tecnologias utilizadas.

Ambos os templates estão disponíveis no meu repositório do GitHub em duas pastas: projetos e estudos.

site explicativo

Indo para além deste repositório, criei uma página web para explicar o porquê devemos documentar e explicar bem o nossos softwares e faço uma relação com documentações de linguagens de programação e outras ferramentas.

Espero que seja útil como tem sido pra mim nos meus repositórios de estudo e projetos pessoais!

LinkedingithubGmail

Muito bom, mano! Adoro customizar os READMEs, markdown é bem simples e funcional. Adicionando, fiz uma sériezinha sobre.

  1. Introdução ao markdown e aos READMEs
  2. Personalizando o README do seu projeto
  3. Personalizando o README do seu perfil do GitHub

Cara, genial! Fazer um readme bom e detalhado exige um esforço significativo (os meus mesmo são mais básicos), gostei muito da idéia.