Live data from Hacker News

Swimlanes.io – generated editable sequence diagrams

swimlanes.io

41–50 of 114 posts

Re: Swimlanes.io – generated editable sequence diagrams

#41
post #5

Prior art: 1. Plant UML: http://www.plantuml.com/plantuml/umla/SoWkIImgAStDuNBCoKnELT... PlantUML supports many diagram types, and there's a nice VS Code plugin with side by side live preview. 2. https://www.websequencediagrams.com/ Has a hand-drawn style option which is nice: https://i.imgur.com/lh4jaVL.png

collated these diagramming tools here: https://github.com/sw-yx/spark-joy/blob/master/README.md#gen...

Re: Swimlanes.io – generated editable sequence diagrams

#42
post #16

Thanks for sharing! Sequence diagrams are awesome. I've used websequencediagrams.com and PlantUML to create them before, and honestly I much prefer using an open source CLI tool for this than a closed source service, even if it's free to use. The day the site goes offline all my Git versioned diagrams would be useless. If the authors are reading: have you considered releasing a standalone CLI tool? It could even be o…

Hi. I created this years ago and have not been able to give it much attention lately. There is a very basic API, https://swimlanes.io/docs/api

Re: Swimlanes.io – generated editable sequence diagrams

#43
For sequence diagrams in text format you can take diagwiz for a spin. There is also an online version of the tool. Disclaimer: It is working, but it's still just an experiment and might change a lot.

https://github.com/kjagiello/diagwiz

https://diagwiz.io/playground/ (not really mobile friendly)

Re: Swimlanes.io – generated editable sequence diagrams

#44
This is really a great tool. I have been using https://www.websequencediagrams.com/ in the past. Will definitely give this one a shot.

Generating quick sequence diagrams helps a lot to articulate ideas. Ever since wfh, I have used these tools a lot of communicate design flow with team mates.

Re: Swimlanes.io – generated editable sequence diagrams

#45
post #42
post #16

Thanks for sharing! Sequence diagrams are awesome. I've used websequencediagrams.com and PlantUML to create them before, and honestly I much prefer using an open source CLI tool for this than a closed source service, even if it's free to use. The day the site goes offline all my Git versioned diagrams would be useless. If the authors are reading: have you considered releasing a standalone CLI tool? It could even be o…

Hi. I created this years ago and have not been able to give it much attention lately. There is a very basic API, https://swimlanes.io/docs/api

You can also embed a diagram. See https://jsfiddle.net/y6Lqpfcw/

Re: Swimlanes.io – generated editable sequence diagrams

#47
post #5

Prior art: 1. Plant UML: http://www.plantuml.com/plantuml/umla/SoWkIImgAStDuNBCoKnELT... PlantUML supports many diagram types, and there's a nice VS Code plugin with side by side live preview. 2. https://www.websequencediagrams.com/ Has a hand-drawn style option which is nice: https://i.imgur.com/lh4jaVL.png

Plantuml plugin within Confluence is pretty nice for documentation, and arguably a super-power because it makes it easier to make good docs ("a picture is worth a thousand words").

The source shows up in edit mode (no external app needed; and it's always correct) and it handles the rendering for you, thus reducing friction.

In other places I've seen people attach a PNG. If you're lucky, they've also attached the corresponding (and up-to-date) source in visio/draw/ppt/whatever random app format, in which case making a small edit might only takes ten of minutes. In the worst case, it's missing source, the source file is not the same as the PNG, or they used some program you don't have, and you have to totally redo it. For most people if the friction is too high, it just doesn't get updated.

Re: Swimlanes.io – generated editable sequence diagrams

#48
post #24

Sequence diagrams seem like the go--to format for displaying data flow in a microservice-type environment, but even though there is a plethora of implementations in various languages and technologies that generate diagrams of this kind, they all lack certain functionalities, number one being the support for threads. Some solutions do provide the "par" fragment, but this is inadequate when message ordering corresponds…

I'm not familiar with those features, and agree that PlantUML generated diagrams have a distinctive look, but why not contribute to PlantUML instead of starting yet another project of this type? It's written in Java, so it meets that requirement.

Re: Swimlanes.io – generated editable sequence diagrams

#50
"Markup for diagram" is great so long as others have a way to edit the markup when you use the diagram in your document.

Blockdiag/Seqdiag has a pretty good RST integration for Sphinx.

Lately I've been using the ZenUML diagram plugin for Confluence which lets you do sequence and other diagrams using Mermaid-JS.

Considering that the author of swimlanes.io seems to have mastered the part where the diagram is encoded into a URL, it feels like making plugins to popular documentation systems is the obvious next step to making this useful for engineering orgs.

Post reply on HN