Commencez par un résultat utile
Décidez ce qu'un visiteur devrait pouvoir faire, quelles données l'application nécessite et sur quels services externes elle dépend. Un site web statique, une API et une tâche en arrière-plan ont des exigences différentes. Décrivez-les séparément même lorsqu'ils partagent un même dépôt.
Gardez les responsabilités visibles
Traitez le code source, les paramètres d'exécution et les données stockées comme des préoccupations séparées. Le code appartient au contrôle de version. La configuration décrit l'environnement. Les données persistantes nécessitent un processus de sauvegarde et de récupération. Cette séparation facilite la modification d'un composant sans reconstruire chaque autre composant.
Rendez l'étape suivante reproductible
Enregistrez la commande de compilation, la sortie attendue et les vérifications qui montrent qu'une version fonctionne. Un autre mainteneur devrait pouvoir suivre les mêmes étapes. Conservez la dernière version fonctionnelle et un moyen pratique d'y revenir. Les guides ici couvrent ces fondamentaux, du premier projet à l'accès à l'API.