Talk:Self-documenting code
Appearance
This article has not yet been rated on Wikipedia's content assessment scale. It is of interest to the following WikiProjects: | |||||||||||
|
Stereotype examples Suggestion
[edit]I find the examples "whichRowOfTheTableWeAreGenerating" or "theIndexOfTheLastItemWeWillProcess" everything except good examples of self-documenting code. It's looks like it's written by someone who doesn't apply this convention in practice.
Examples like "whichRowOfTheNewTable" or "theIndexOfTheLastRawItem" would make more sense RoestVrijStaal (talk) 12:29, 31 August 2015 (UTC)
Oxymoron
[edit]The only code that is actually self documenting is code that has explanatory narrative embedded as in, e.g., Donald Knuth's WEB. Meaningful labels, procedure names and constant names help, but are not enough in themselves. Shmuel (Seymour J.) Metz Username:Chatul (talk) 17:50, 17 January 2020 (UTC)