3 ms·
Or worse yet, docs that aren't written by a human, but extracted out of comment-less source code. There is a tendency to actually document the first point of c
by mikewarot 5y ago
Or worse yet, docs that aren't written by a human, but extracted out of comment-less source code.
There is a tendency to actually document the first point of contact with code, but nothing after that.
- chousuke 5y agoThis results in absolutely delightful documentation with things like embedded DSLs (I have suffered slight trauma from Ruby ones) where the documentation contains 90% incomprehensible voodoo incantations that exist just to make the DSL look pretty.