Edge Rewrite
Jump to content

Talk:Self-documenting code

Page contents not supported in other languages.
Add topic
From Wikipedia, the free encyclopedia
Latest comment: 6 years ago by Chatul in topic Oxymoron

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)Reply

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)Reply