Comece com um resultado útil
Decida o que um visitante deve ser capaz de fazer, quais dados o aplicativo precisa e de quais serviços externos ele depende. Um site estático, uma API e uma tarefa em segundo plano têm requisitos diferentes. Descreva-os separadamente mesmo quando compartilham um repositório.
Mantenha as responsabilidades visíveis
Trate o código-fonte, as configurações de tempo de execução e os dados armazenados como preocupações separadas. O código pertence ao controle de versão. A configuração descreve o ambiente. Dados persistentes precisam de um processo de backup e recuperação. Essa separação facilita a alteração de um componente sem reconstruir todos os outros componentes.
Torne o próximo passo repetível
Registre o comando de build, a saída esperada e as verificações que mostram que uma versão funciona. Outro mantenedor deve ser capaz de seguir os mesmos passos. Mantenha a última versão funcional e uma forma prática de retornar a ela. Os guias aqui cobrem esses fundamentos desde o primeiro projeto até o acesso à API.