3 ms·
self-documenting code only says what it does but does not say anything about what it's supposed to do or explain why
by snorkel 16y ago
self-documenting code only says what it does but does not say anything about what it's supposed to do or explain why
- rimantas 16y agoYou may be right about why, but I don't agree on what. Good names for functions/methods can tell a lot. I feel like I am getting spoiled by Objective-C and Cocoa Touch APIs.
- nadnerb 16y agoSelf documenting code should be accompanied tests, which further replaces the need for documentation. It also has less chance to rot.