8 ms·
YUML – Easy Embeddable Diagrams
- mcqueenjordan 8y agoAnyone familiar with PlantUML[1]? That's been my goto for declarative text-based diagramming. I've always thought "there really could be a better tool," but I've never found anything better than PlantUML. I don't think YUML is going to be my answer, though -- it's paid and doesn't seem to be a local tool, but rather a SaaS model. This product feels like it should be a local compile-into-image workflow. But that's probably my bias for text-based declarative formats coming through. :) [1] http://plantuml.com/ http://plantuml.com/
- foundart 8y agoPlantUML is great! Key benefits you get from a good text-based diagramming tool: - easy iteration (for example: search and replace with a text editor to rename things) - readable diffs in your version control system
- angleofrepose 8y agoAny other ideas on what "could be the better tool"? I haven't really used plantuml or one of the couple of others like memraid or flowchart other than playing around with them, but my dream tool in that arena is something that has the same accessibility (`->` and other minimal notation) but to drive more of the note taking process like I have on paper. I think it would be great to be able to right justify or write on both sides of the same line or otherwise position text or wrap it in a box like can be easily done in a tool like OneNote(or my notebook) but driven entirely by the keyboard. If there were something like markdown but for text positioning rather than styling. It seems to me that a keyboard driven OneNote would be fantastic. I already do a lot of writing in my vim/markdown setup because folding is so useful. I just want more mindmap style control, or the ability to define my own notations. On paper I often comment or converse with ideas on the right third of the page, and I should be able to do that with a `<` denotation just like markdown does blockquote with `>`.
- gegtik 8y agoI keep coming back to it too. I would love for some more control on layout but it works for simpler diagrams
- TeMPOraL 8y agoLayouting in plantuml is tricky, but I learned some tricks the hard way, which make larger diagrams more tenable. One core trick is: upper/left arrow lower/right So e.g. you write: upperBlock <-- lowerBlock instead of: lowerBlock --> upperBlock This alone drasticly cuts on the amount of hidden arrows with forced directions you need to use in larger diagrams. That said, plantuml could use a more explicit way of providing layout hints. E.g. an extra declaration that some objects form a grid. Something like: grid Comp1 Comp2 Comp3 Comp4 Comp5 Comp6 endgrid
- tobinharris 8y agoyUML creator here. Think I know what you're saying. That said, there are many people using a command line wrapper to generate yUML diagrams as part of an automated workflow. The paid features are more for people who want better management of diagrams.
- beardedwizard 8y agoYa but I have to leak you my diagrams. Websequencediagram already does this. Plantuml allows a local renderer.
- foreigner 8y agoThank you for this awesome tool! I use YUML all the time to embed diagrams in to markdown documents on GitHub. I use PlantUML sometimes too, but I love that YUML has no compilation step and the "source"of the diagram is in the link and legible to humans. I wish I could use YUML to make flow charts!
- tobinharris 8y agoThanks for the feedback! Yes, we sometimes create flowcharts ourselves so would be a nice addition.
- tomc1985 8y agoHonestly you're right. I'm not inclined to give the time of day to yet another SaaS project that should have been a command-line tool
- noir_lord 8y agoMe either, I mean I pay for Netflix and Intellij out of my own pocket (even though I use the latter at work) but when it comes to SaaS I just multiply the monthly price by 12 and think "hah, no thanks". I've no issues with paying for a SaaS but it has to provide value and this for me doesn't.
- asicsp 8y agoI haven't personally used it so far, but check out mermaid[1] which I bookmarked from a HN[2] discussion [1] https://mermaidjs.github.io/ https://mermaidjs.github.io/ [2] https://news.ycombinator.com/item?id=16889181 https://news.ycombinator.com/item?id=16889181
- blablablerg 8y agographical software (even Powerpoint) still works best IMHO
- ujuj 8y agoI found mermaidjs to be interesting in cases where you want to put down some diagrams quickly. However the renders/SVG export are really wonky at the moment.
- deleted 8y ago[deleted]
- dhimes 8y agoThis isn't something I spend a lot of time on. I settled on Dia long ago and it works fine for my purposes.
- billfruit 8y agoI also like Plantuml, but it does not do that good a job with statecharts.
- blitmap 8y agoI prefer this: https://casual-effects.com/markdeep/ https://casual-effects.com/markdeep/
- Improvotter 8y agoDo you have any idea on how to use PlantUML with LaTeX files? I've only found some workaround scripts that make it pretty ugly to begin with. I'm using Overleaf so I doubt it'll add the functionality, but it'd be neat.
- Nullabillity 8y agoNo idea about raw LaTeX, but with Org you can just include it as a source block, and Babel will automatically compile it for you when you do a LaTeX export.
- Improvotter 8y agoI'm no expert, but are you referring to this? https://orgmode.org/manual/Quoting-LaTeX-code.html https://orgmode.org/manual/Quoting-LaTeX-code.html
- jillesvangurp 8y agoIn the rare case that someone insists on diagrams, I usually go for umlet. It's quirky but it gets the job done. Frankly, I think UML is a waste of time. Anything that fits in a diagram, is too trivial to document. It's the stuff that doesn't fit that matters more. And attempting to document a very complex system with UML is both pointless and painful. Most diagrams I've seen just state the bleeding obvious. There's a thingy; it uses another thingy and extends that other thingy over there. Best case it's not a complete over simplification; worst case it tells less than half the story or it is hopelessly out of date because diagrams rot even faster than code. IMHO the best diagrams are those on whiteboard that you wipe out after the meeting. Don't bother taking photos, nobody ever looks at those.
- lnyng 8y agoNot exactly for the same purpose, but anyone knows about Graphviz [1]? Super expressive and you can visualize online in viz.js [2]. [1] https://www.graphviz.org/ https://www.graphviz.org/ [2] http://viz-js.com/ http://viz-js.com/
- WestCoastJustin 8y agoI've been using Vis.js and http://shaky.github.bushong.net/ http://shaky.github.bushong.net/. You can do really cool stuff with them. Highly recommend them both. I will import those into gimp and create all types of animation with them [1, 2]. I've built a db backend for vis.js and it makes to super simple to connect things and saves the positions for Vis.js. You can see a demo of it here: https://sysadmincasts.com/map https://sysadmincasts.com/map. Try zooming in/out, moving things, etc. I should probably open-source the code as others might like an example of it too. [1] https://assets.sysadmincasts.com/e/g/45-ansible-ping-pong.png https://assets.sysadmincasts.com/e/g/45-ansible-ping-pong.pn... [2] https://assets.sysadmincasts.com/e/g/47-ansible-load-balancer-serial-task-orchestration.gif https://assets.sysadmincasts.com/e/g/47-ansible-load-balance...
- victor106 8y agoThis looks really cool. Will check it out
- i_am_proteus 8y agoI really like Graphviz; I really don't like that the latest MacOS release doesn't support it (yet). I mostly use Linux, but it's still a headache.
- jupp0r 8y agoYou have it backwards. Graphviz doesn’t support the latest MacOS release, not vice versa.
- andreareina 8y agoGraphviz is one of the things that I make sure is installed when I get a new computer, along with PlatUML (also mentioned).
- weekay 8y agoClass, activity and use case diagrams are not in vouge with the development teams. And if they do use them , they tend to be in Visio or with similar tools when they need to be created for requirements / design documentation etc., Somewhat related , https://bramp.github.io/js-sequence-diagrams/ https://bramp.github.io/js-sequence-diagrams/ could be used as well.
- lsiebert 8y agoI've used this to help sketch out a DB schema several times.
- WestCoastJustin 8y agoHave you seen this one? I have been using that and it's pretty awesome. Exports nicely too. https://ondras.zarovi.cz/sql/demo/?keyword=default https://ondras.zarovi.cz/sql/demo/?keyword=default
- lsiebert 8y agoI had not, but then I was using a DSL for sql generation.
- kawera 8y agoAnother one: https://github.com/knsv/mermaid https://github.com/knsv/mermaid
- tobinharris 8y agoWhat diagrams do you see used in dev teams these days? In our team (non enterprise), there's a lot of visual flow models for UX, and still some class/interaction/activity diagrams for explaining how stuff hangs together.
- max_sendfeld 8y agoBeen using https://arcentry.com/ https://arcentry.com/ for architectural diagram. They offer a 3D viewer that can be embedded as well
- etaioinshrdlu 8y agoPrevious discussion, from 2009: https://news.ycombinator.com/item?id=594682 https://news.ycombinator.com/item?id=594682
- pknerd 8y agoI wonder why are they not using JSON?
- _ZeD_ 8y agoAdd https://www.websequencediagrams.com/ https://www.websequencediagrams.com/ to the list :D
- frabert 8y agoOff topic, but seeing the word "embeddable" in this context reminds me of old Microsoft OLE. It was kind of cool being able to drag an excel table inside an Access form, together with a media player and stuff like that...
- fouc 8y agoHow about diagrams that you can embed in your markdown documentation? Proper ascii drawings: http://asciiflow.com http://asciiflow.com
- dhimes 8y agoOr even put into the comments section of your code... great tool!
- Hates_ 8y agoMonodraw is a great Mac app for creating them https://monodraw.helftone.com/ https://monodraw.helftone.com/
- luckman212 8y agoYeah Monodraw was great. Too bad he sunsetted it last October[0]. [0] https://blog.helftone.com/monodraw-maintenance-mode/ https://blog.helftone.com/monodraw-maintenance-mode/
- quickthrower2 8y agoIs UML cool again? I’ve been waiting 2 decades. Please say it is! Surely now that monoliths are the new black, UML must be respectable.
- ndnxhs 8y agoI am convinced uml was created to sell expensive tools for using uml. If I never have to see it again I will be happy.
- AkashSKY 8y agoThank you for sharing this article. I love it. Keep on writing this type of great stuff. http://bestbuyonlin.com/ http://bestbuyonlin.com/ http://bestbuyonlin.com/blog/ http://bestbuyonlin.com/blog/ http://bestbuyonlin.com/razer-blade-15-review/ http://bestbuyonlin.com/razer-blade-15-review/ http://bestbuyonlin.com/hp-spectre-x360-13-inch-review/ http://bestbuyonlin.com/hp-spectre-x360-13-inch-review/ http://bestbuyonlin.com/acer-swift-7-review/ http://bestbuyonlin.com/acer-swift-7-review/ http://bestbuyonlin.com/microsoft-surface-laptop-3/ http://bestbuyonlin.com/microsoft-surface-laptop-3/
- deleted 8y ago[deleted]
- laythea 8y agoSaaS for diagrams? No thanks! It's probably very good software, but I can't tolerate the business model, sorry.
- monkeydust 8y agoNice I like the scruffy mode, something about it captures the eye more than a clean cut shape you can put together on PowerPoint.
- jimmcslim 8y agoI'm a big fan of the C4 model [1] for diagramming and documenting software architectures. There is a SaaS tool, Structurizr [2], for diagramming, documenting, and exploring such models, plus also set of PlantUML styles [3] for generating C4 using that tool. [1] https://c4model.com/ https://c4model.com/ [2] https://structurizr.com/ https://structurizr.com/ [3] https://github.com/RicardoNiepel/C4-PlantUML https://github.com/RicardoNiepel/C4-PlantUML
- rayrrr 8y agoRegister to self-host a thing named after a well-known open source standard? Nah...in fact, I'm feeling a sudden urge to make open source contributions to PlantUML and/or MermaidJS.