News for hackers. Stuff that matters.
Re:Sequence diagrams, the only good thing UML brought to sof... by hitchstory on Friday June 16, 2023 @04:39AM (#36353362)
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.

Re:Sequence diagrams, the only good thing UML brought to sof... by sfn42 on Friday June 16, 2023 @07:07AM (#36354600)
> 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.

Re:Sequence diagrams, the only good thing UML brought to sof... by bluGill on Friday June 16, 2023 @09:19AM (#36356098)
Name 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.