> Poorly written or out of date documentation is worse than no documentation.
No, it's not. I _can_ be, but it can also be much better. Documentation is hard, we know that. But it's also incredibly useful in many cases. There are plenty of times where software is nearly useless, or the time required to use it becomes untenable, without documentation.
Honestly, I feel the same way about the code; if you can't be bothered to put a note in a file indicating what it's for (unless it's clearly obvious to a casual observer with limited domain knowledge), then you shouldn't be writing software at all.
No, it's not. I _can_ be, but it can also be much better. Documentation is hard, we know that. But it's also incredibly useful in many cases. There are plenty of times where software is nearly useless, or the time required to use it becomes untenable, without documentation.
Honestly, I feel the same way about the code; if you can't be bothered to put a note in a file indicating what it's for (unless it's clearly obvious to a casual observer with limited domain knowledge), then you shouldn't be writing software at all.