2 ms·
Sure, I don't think there is a free lunch. But if this is the cost of rewriting isn't that the argument for having documentation? I mean I'm not running into w
by godelski 3y ago
Sure, I don't think there is a free lunch.
But if this is the cost of rewriting isn't that the argument for having documentation? I mean I'm not running into well written code and I'm just told to add my thing to it. But to do that I need to interact with... well... a house of cards. Because the person before me wrote fast, not well. I do hear a lot of people say that they write their code so well it doesn't need documentation but I've only run into code that is clear pretty rarely. Though every time that happens, they also have documentation available.
Thanks for the clarification with power users. As one, I have no issues with this response. I know we always want more but I get the tradeoff for usability. Only thing I'd say is that, depending on what's being programmed, exposing API can often be all I need and typically doesn't do anything for the average user. But that's often not reasonable so I totally get this one.