Professional Documents
Culture Documents
(Download PDF) Communication Patterns A Guide For Developers and Architects 2Nd Early Release 2Nd Edition Jacqueline Read Ebook Online Full Chapter
(Download PDF) Communication Patterns A Guide For Developers and Architects 2Nd Early Release 2Nd Edition Jacqueline Read Ebook Online Full Chapter
(Download PDF) Communication Patterns A Guide For Developers and Architects 2Nd Early Release 2Nd Edition Jacqueline Read Ebook Online Full Chapter
https://ebookmeta.com/product/modernizing-enterprise-java-a-
concise-cloud-native-guide-for-developers-early-release-1st-
edition-markus-eisele/
https://ebookmeta.com/product/c-cookbook-modern-recipes-for-
professional-developers-early-release-1-fifth-
release-2021-06-30-edition-joe-mayo/
https://ebookmeta.com/product/data-algorithms-with-spark-recipes-
and-design-patterns-for-scaling-up-using-pyspark-early-
release-1-2021-09-10-fourth-early-release-edition-mahmoud-
parsian/
https://ebookmeta.com/product/restful-web-api-patterns-and-
practices-cookbook-fifth-early-release-mike-amundsen/
OpenShift for Developers: A Guide for Impatient
Beginners 2nd Edition Joshua Wood
https://ebookmeta.com/product/openshift-for-developers-a-guide-
for-impatient-beginners-2nd-edition-joshua-wood/
https://ebookmeta.com/product/r-for-data-science-2nd-edition-
early-release-hadley-wickham/
https://ebookmeta.com/product/r-for-data-science-2nd-edition-
third-early-release-hadley-wickham/
https://ebookmeta.com/product/qiskit-pocket-guide-early-release-
james-l-weaver/
Communication Patterns
A Guide for Developers and Architects
With Early Release ebooks, you get books in their earliest form—
the author’s raw and unedited content as they write—so you can
take advantage of these technologies long before the official
release of these titles.
Jacqui Read
Communication Patterns
by Jacqui Read
Copyright © 2024 Read the Architecture Ltd. All rights reserved.
Printed in the United States of America.
Published by O’Reilly Media, Inc., 1005 Gravenstein Highway North,
Sebastopol, CA 95472.
O’Reilly books may be purchased for educational, business, or sales
promotional use. Online editions are also available for most titles
(http://oreilly.com). For more information, contact our
corporate/institutional sales department: 800-998-9938 or
corporate@oreilly.com .
This chapter contains the foundation that we build upon with the
other patterns and antipatterns in this section.
I highly recommend making sure you are employing the patterns
and antipatterns in this chapter, before building on them with all the
others. Think of it the same way as building architecture: you need
to get the foundations right before you can build the walls, floors
and finally the roof. Don’t start building on sand. Get these ones
right first.
YOUR AUDIENCE
Make a list of who views your diagrams and then create groups based
on the types of diagrams you create. You will likely find that you have
different audiences for different diagrams. Use these lists with the
questions later in this section.
There are several questions you should ask yourself about your
audience, once you have identified who they are.
Figure 1-6 shows how the context diagram for Figure 1-5 should
look. This is where the software system in focus belongs, with its
related external systems and actors.
Figure 1-6. C4 context diagram
Colour Overload
When talking about this antipattern I often refer to it as an Explosion
of Unicorns. In most cases, the colours used in diagrams are not
given much, if any, thought at all. Often many colours are used,
either to indicate the difference between different components, or
with no meaning at all. If a key is included it is long and takes time
and concentration from the audience to work out what is what.
This antipattern usually occurs because the author of the diagram
had no motivation to consider colour or no idea that colour is
important in visual communication. Either the default colours in a
diagraming application or randomly selected colours are used,
because that is quicker than taking the time to think about the
colours being used.
TIP
Here we have an example of being “penny-wise but pound-foolish”:
saving time creating the diagram will mean more time (or money) is
spent later either explaining to audiences, having to redo the diagram,
or even clear up the mess resulting from miscommunication. In the
same way as fixing bugs in code early, getting communication right
early will save you money and time in the long-run.
This antipattern applies not just to diagrams but to all visuals, except
those purely in black and white (that is black and white only, and not
greyscale). But don’t think the answer is to create all visuals in black
and white. The way to combat this antipattern is to consider colour
and use it to communicate.
Figure 2-1 shows an overpowering array of bright colours used to
show that each component in the diagram is different but without
any consideration for communication. Have a think about how you
would fix this before reading on.
Figure 2-1. Rainbow sequence diagram
To fix this we must minimise the colour palette, only using the
number of colours needed to convey your message. You don’t need
a different colour for every component in your diagram. When
selecting colours consider which colours go well together (don’t
clash), and also the luminosity of the colours as too many bright
colours will overwhelm your audience.
Other than the selection of colours you need to consider what you
are trying to communicate to your audience via these selected
colours. You can use them to communicate things like function or
type by using the same colour for components that share this
feature. For example, see Figure 2-1 where colour has been used to
show that the UI, data store, APIs and services are different.
Figure 2-2. Colours grouping by type
The example shown in Figure 2-2 is isn’t the only option for
improving the diagram shown in Figure 2-1, but it implements the
fixes just mentioned to produce a diagram that the audience can
understand and view without distraction from the message of the
diagram. Avoiding distractions from your message is key to
successful communication.
Language: English
ILLUSTRATED BY
H. S. BARBOUR