J'utilise git au quotidien depuis plus de 10 ans maintenent et git-rebase est tout simplement l'une de mes fonctionnalités préférée. Pourtant, lorsque je donne des formations sur Git, je m'aperçois que cette commande est souvent mal comprise et mal utilisée. Nous allons donc étudier en détail la commande git-rebase : À quoi elle sert vraiment, et comment bien l'utiliser.
Par exemple, il m'arrive fréquemment, quand je facture un client, de devoir
inclure dans la facture des remboursements de frais. Et à chaque fois, je peste
car j'ai totalement oublié la bonne façon de faire.
Pour les neuneus en compta comme moi, voici donc la méthode facile et logique
pour émettre une facture qui intègre des remboursement de frais.
Ces quelques années m'ont amené à considérer certaines façons de faire plutôt
que d'autre, et à compiler une liste de bonnes pratiques qui me paraissent
positives dans la majorité des cas.
Ces bonnes pratiques ont différents objectifs, qui finissent plus ou moins par
se rejoindre :
Du coup, on se retrouve souvent avec des docs pourries et donc des logiciels
difficiles / pénibles à utiliser.
Voyons donc comment documenter correctement une application Django (ou
n'importe quel projet Python, hein, c'est juste pour l'exemple concret et mon
référencement).
Il y a quelques jours, alors que je bossais sur mon pet project du moment, je
me suis surpris à penser « tiens, ça serait bien si cette fonctionnalité
devenait une application Django réutilisable ». La fonctionnalité en
question ne nécessitant pas plus de quelques lignes, je me suis dit que ce
serait rapidement torché.
Le fait que je me retrouve 10 jours plus tard et deux applications
supplémentaires me prouve encore une fois que je suis vraiment mauvais avec les
estimations. Et on s'étonne que je ne travaille pas au forfait …
Quoi qu'il en soit, pour la dernière app, j'ai décidé de tester l'approche
Documentation Driven Development. Retours d'expérience.