Documenter et tester notre code Rust
Je crois utile et important d’apprendre les bonnes pratiques dès les tout débuts de l’apprentissage d’un langage (ou de quoique ce soit d’autre).
Aussi, je vous propose d’apprendre tout de suite à écrire une documentation claire, à y fournir des exemples d’utilisation et à écrire des tests unitaires complémentaires qui n’apparaissent pas dans la documentation mais qui consolident durablement nos codes sources.
Nous allons utiliser un « fil rouge » très simple pour illustrer le propos et le mettre en pratique : nous allons construire une petite ébauche de librairie de fonctions mathématiques élémentaires.
J’ai choisi ce fil rouge pour que les codes sources que nous produisons soient à la fois les plus simples possibles et formateurs par eux-mêmes.