Making diagrams readable
Use clear names, layers and layout to make a card-pack diagram easier to inspect and share. It’s important to keep your diagrams clear and readable.
It’s important to keep your diagrams clear and readable; whether for your own benefit, or for others in your team who might need to use them.
Here are a few best practices:
Hidden layers can be used to hide anything that harms readability. This includes things like state connections and secondary calculations.
In this example, we can hide these State Connections because their purpose (to sum up all the Pools) is self-evident. This is helped by the fact that we’ve given clear names to our components.
Use images and color-coding to distinguish each section. This allows readers to segment out parts of the diagram in their mind, making it more digestible.
Building diagrams left-to-right, or otherwise highlighting the starting point, helps readers establish the sequence of events with minimal effort.