4 ms·
It's not a question of laziness. People just need to use better tools to generate docs and fail CI if the implementation and docs diverge. I used to hear peopl
by hitchstory 3y ago
It's not a question of laziness. People just need to use better tools to generate docs and fail CI if the implementation and docs diverge.
I used to hear people say the same thing about laziness about code style before reformatting/linting tools became standard.
- sfn42 3y ago> It's not a question of laziness, it's just that people don't do it so you need automated tools to do it for them Sounds a lot like laziness to me. It may be more accurate to say it's because people don't care. I've seen projects full of typos. Ive seen projects where basically everything had been duplicated not once but twice because they wanted a slightly different version of the same website so instead of adding some configuration or otherwise finding a reasonable solution for it they just went and copied hundreds of files and prefixed their names before making a couple minor changes and leaving the mess for someone else to discover. No mention anywhere of the fact that this had been done, nor why. These are the actions of people who don't give a shit. Whatever problems they create are someone else's problems. The way i see it, if you care about your work you'll make sure the code is readable, well documented and so on. If you don't, you won't.
- bluGill 3y agoName me a tool that verifies UML and code are up to date in ci. Now lets add requirements that it is good UML. Don't forget that some details shouldn't be in UML.