Literate programming, écrire un roman en Python

Allez je lance un sujet sur un concept que je trouves assez peu répandu et qui pourtant me semble génial.

Le literate programming (fr.wikipedia.org/wiki/Programmation_lettrée)

Je ne vais pas répéter wiki, mais en gros c'est l'idée de diminuer la charge mental lors de la maintenance et évolution du code.

En ajoutant des abstractions et en faisant un découpage clair des responsabilités, on garantis une compréhension bien plus rapide des différents comportements.
Sans avoir besoin de tout décortiquer pour en sortir un sens. Le nom donné au comportement (fonction) doit pouvoir raconter une histoire au développeur.

Petit exercice pour exemple  



Si le café est trop amère pour Bob, même un non initié, et à fortiori un développeur nouveau sur le projet, va assez vite comprendre les interactions et savoir où regarder précisément pour adoucir le café. (Essayez donc de le faire évoluer ça peut-être marrant !)

Une simple graine qui pourquoi pas donnera un arbre de discussion sur des concepts proches, de qualité logiciel au sens : maintenabilité et évolutivité.