Communication Patterns: A Guide for Developers and Architects (2nd Early Release) [2 ed.] 9781098140540, 9781098140489

Having a great idea or design is not enough to make your software project succeed. If you want stakeholders to buy into

882 406 25MB

English Pages 250 Year 2023

Report DMCA / Copyright

DOWNLOAD FILE

Communication Patterns: A Guide for Developers and Architects (2nd Early Release) [2 ed.]
 9781098140540, 9781098140489

Table of contents :
I. Visual Communication
1. Communication Essentials
Know Your Audience
Style Communicates
Mixing Levels of Abstraction
2. Clarify the Clutter
Colour Overload
Boxes in boxes in boxes
Ambiguous Connections
Balance Text
3. Accessibility
Relying on Colour to Communicate
Include a Legend
Appropriate Labels
4. Narrative
Match Diagram Flow to Expectations
The Big Picture Comes First
Clear Relationships
5. Notation
Using Icons to Convey Meaning
Using UML for UML’s Sake
Mixing Behaviour and Structure
Going Against Expectations
6. Composition
Illegible Diagrams
Representational Consistency
Misleading Composition
Create a Visual Balance
II. Multi-Modal Communication
7. Written Communication
Simple Language
Acronym Hell
Structuring Your Writing
8. Verbal and Non-Verbal
Encoding Messages
Decoding Messages
Persuasion
9. The Rhetoric Triangle
Ethos
Establish Your Credentials
Use Trustworthy Sources
Transparency
Demonstrate Your Knowledge
Pathos
Speak from the heart
Use vivid language & strong imagery
Tell a story
Logos
Use data and facts
Make logical connections
Use reasoning and argumentation
III. Communicating Knowledge
10. Knowledge Management Principles
Products over Projects
Abstractions over Text
Perspective-Driven
11. Knowledge and People
Getting Feedback Early & Often
Share the load
Just-in-time Architecture
12. Effective Practices
Using Architecture Decision Records (ADRs)
Effective Architecture Characteristics
All Documentation as Code
Technical Documentation
Other Documentation
Automatically Generated Documentation
IV. Communicating Remotely
13. Remote Time
Synchronise Time
Working Patterns
Energy & Productivity
14. Remote Principles
Meetings to Synch
Async to Think
Remote-First
15. Remote Channels
Symmetrical Email
Online Presentations
Remote Tools & Governance
About the Author

Polecaj historie