DEV Community

Jesse Phillips
Jesse Phillips

Posted on • Edited on

3

Text based diagramming

Update: I forgot to mention that I was utilizing plantuml.

I read an article about writing your diagrams in text rather than a graphical tool. This was a reminder to me as I had come across that for a sequence diagram I wrote. I've not been happy with the graphical choices out there. Generally they are filled with so many shapes and connectors I don't really know how to put it together.

Sequence diagram in text made sense. The flow was represented in the text, and the graphics render just made it that much clearer.

The next one I did was a component diagram, this time I was actually looking to visually represent an existing diagram to maintain familiarity while expanding on it. I have mixed feelings, but I was successful (mostly).

I did not need to size boxes place text and move around groups. I just had to define the relationships. That and the right groupings. And with the proper settings.

After learning some of the syntax nuances it became about specifying the right details. Because all of the connections details meant lines everywhere.

I'm going to try making additional diagrams, but I don't know how the maintenance will be. Your relationship are grouped, but what is the right grouping?

Speedy emails, satisfied customers

Postmark Image

Are delayed transactional emails costing you user satisfaction? Postmark delivers your emails almost instantly, keeping your customers happy and connected.

Sign up

Top comments (0)

Billboard image

The Next Generation Developer Platform

Coherence is the first Platform-as-a-Service you can control. Unlike "black-box" platforms that are opinionated about the infra you can deploy, Coherence is powered by CNC, the open-source IaC framework, which offers limitless customization.

Learn more