Skip to content

Instantly share code, notes, and snippets.

Show Gist options
  • Select an option

  • Save sudo-give-me-coffee/a5b6fd1c23a6929aa2a02be7617e57ed to your computer and use it in GitHub Desktop.

Select an option

Save sudo-give-me-coffee/a5b6fd1c23a6929aa2a02be7617e57ed to your computer and use it in GitHub Desktop.
Ilustra um readme limpo e fácil de entender


Nome do projeto | Download

O que é?

Descreva seus projeto em uma linguagem não técnica, aqui serve para apresentar seu projeto se ele aparecer numa loja de apps aqui a descrição não seria muito diferente dessa

Como se usa?

Explique como se usa aqui vale ser mais técnico, use de tabelas e dos campos com ``` cite exemplos de uso se for um comando no terminal, apresente as flags e parâmetros do terminal se for o caso, comandos do bot se for um bot no telegram, etc...

Como instalar?

Coloque os diversos passo a passo para instalar, use a TAG detail, ou use um heading nível 3 para separar as plataformas/métodos (linhas começando com ###)

Screenshots

Coloque imagens de preferência 720p centralizadas demonstrando telas do projeto se for GUI, caso for um comando no terminal pode gerar um GIF com a saida e postar tem várias ferramentas que permitem isso, por exemplo a terminalizer

Roadmap

Mostre usando tasklists o que vai ser implementado no futuro ou o que falta ser implementado, no segundo caso seria interessante trocar Roadmap por "To-do"

A sintaxe é essa:

- [ ] Essa é uma feature que ainda não foi implementada
- [x] Essa é uma feature que já foi implementada

Fica assim:

  • Essa é uma feature que ainda não foi implementada
  • Essa é uma feature que já foi implementada

Créditos

Aqui você cita quem te ajudou no projeto com implementações de features ou mudanças significativas, só toma cuidado pra não virar um changelog, os créditos para mudanças e correções de bugs simples devem ir pro changelog, um exemplo:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment