|
|
|
|
|
|
by jfb
4621 days ago
|
|
|
No. The best kind of documentation is the kind that explains the non-obvious decisions taken in the code. Or the kind that outlines the interactions between function x and states 1-3. Or the kind left behind by some poor bastard archaeologist who comes in after the fact to fix the appallingly opaque ball of hair I pooped out under terrible deadline pressure. Documentation has multiple purposes, and multiple audiences, and a good static type checker can't do anything for most all of them. |
|
|