3 ms·
> Documentation represents the compromise between a perfect interface and shipping pressure. The gap can be minimized but never eliminated. Never say never. So
by lmm 8y ago
> Documentation represents the compromise between a perfect interface and shipping pressure. The gap can be minimized but never eliminated.
Never say never. Some perfect code, needing no more documentation than the types, does get shipped - look at some of Edward Kmett's work.
Sometimes you can't figure out the perfect solution and have to resort to the crutch of documentation. But it's not inevitable.