Sequence diagrams, the only good thing UML brought to software development
Thinking &quot;the only good thing&quot; is understandable, since there&#x27;s a lot of noise, but that talk discourages people from learning a lot of good stuff that&#x27;s buried.<p>Before UML, there were many methodologies.  UML was started by a unified team of some of the most noted OO methodologists.<p>There was a lot of good thinking, but one of the adoption problems we had before UML (as tools developers and methodologists) was that many people got a poor introduction to it, and missed the whole point.<p>For example, on a diagram metamodel that emphasized formalizing and visualizing the relationships among objects... some people would think it was a TPS Cover Sheet task, to laboriously draw their class inheritance hierarchy and summarize their attributes and method signatures, for purely corporate bureaucratic reasons.<p>You could also contrast people who needed to build complex embedded system behavior, for whom Statecharts were a very valuable tool for keeping the model manageable -- distinguished from people who were told to do it when it wasn&#x27;t appropriate, and they just kinda tried to document their code control flow by misusing that same diagram notation.<p>Today, I can&#x27;t blame people for not understanding, since most examples they&#x27;ll now see are incorrect noise, and the current UML spec itself doesn&#x27;t do this reputation any favors.<p>Half-seriously, maybe we could use a reset, in which people who neither know or care what they&#x27;re doing <i>stop being required to go through the motions of pretending to do it</i>.  Also stop trying to have people who don&#x27;t actually use it teach it to students who just want a good grade in the class (for their FAANG job application), and who have little-to-no experience necessary to appreciate the real thing.  Also don&#x27;t make it a marketable resume keyword.  Then the only people who will be doing or talking about it are people who care enough to figure out the genuine merits, with no incentive to pretend.<p>Then, ideally, the only time others will see it is when someone whips out a formalized diagram for something complicated, and proceeds to start explaining it by walking the audience through the diagram... Some people in the audience will get the tingles, as they&#x27;re not only understanding, but they&#x27;re also sensing a very powerful modeling tool that would address some problems that they and their team have in their work.  (Realistically, this would start to happen, but as soon as it becomes a resume keyword or interview ritual, history would repeat, but maybe that time with a larger mitigating mass of people who understand and appreciate.)