O arquivo README geralmente segue um formato para orientar imediatamente os desenvolvedores sobre os aspectos mais importantes do projeto.
O nome do projeto é o primeiro item do readme. Comece o documento com essa informação. Dê preferência de ênfase na formatação desse item, ou seja, ele deve ser um título.
Segue-se uma descrição do projeto. Uma boa descrição é clara, curta e direta.
Liste as dependências que são obrigatórias no projeto. Se possível anexe link para a documentação
Exemplo:
- Node.js 10.13 ou maior. Doc's
Descreva detalhadamente, em passos, como configurar e executar a aplicação.
Exemplo:
-
Renomeie o arquivo example.env.local para:
.env.local -
Suba a aplicação rodando:
npm run dev
http://localhost:3000
No item de tecnologias usadas é importante colocar links para que seja fácil a identificação da documentação oficial.
Exemplo: