Jump to content

Talk:Self-documenting code

Page contents not supported in other languages.
From Wikipedia, the free encyclopedia

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]