Good Habits for Great Coding: Improving Programming Skills with Examples in Python

© Michael Stueben 2018

Michael StuebenGood Habits for Great Codinghttps://doi.org/10.1007/978-1-4842-3459-4_6

6. Self-Documenting Code

Michael Stueben¹ 

(1)

Falls Church, Virginia, USA

 

• I feel disloyal but dauntlessly truthful in saying that most scientists do not know how to write, insofar as style does betray l’homme même [the man himself], they write as if they hated writing and wanted above all else to have done with it.—Sir Peter B. Medwar (Nobel Laureate), Advice to a Young Scientist (Harper & Row, 1979), page 63.

• It is remarkable that nearly all scientists, at the point where they turn from mathematical or chemical language to English, seem to feel relieved of any further obligation to precise terminology.—Robert Graves and Alan Hodge, The Use ...