3 ms·
Because they understand the value it holds and put in the work to maintain it. Documentation is expensive. Good documentation is more expensive, requires diffe
by _jal 4y ago
Because they understand the value it holds and put in the work to maintain it.
Documentation is expensive. Good documentation is more expensive, requires different skillsets than most engineers have, and requires a bit of an organizational commitment to make work.
That last part is more difficult in Linux-land than BSD-land, which is only a partial excuse. The main reason it almost universally sucks is that people put up with it, so managers are more than happy to cut those expensive tech writers.
- setr 4y agoI think it has more to do with the lack of metrics to be defined — and thus tracked. It’s easy enough to track features, and even code quality (by # of bug reports); you can track documentation by “coverage” — each feature has some kind of page — but it’s difficult to define and track for documentation being comprehensive and well-written. And if it’s not tracked… it’s invisible