20250424_Reliable Communication Through Diagrams

Transcript

1. Reliable Communication Through Diagrams Sasaki Yuta
2. Simple Diagrams Can Make Our Communication More Reliable
3. System Reliability
4. Communication Reliability System Reliability
5. Have you ever received messages like this? Introduction
6. Made you spend extra time searching for answers Does This Sound Familiar? Introduction Invest 60 min Ask
7. Have you ever sent messages like this? Introduction
8. Triggered negative reactions due to lack of context Does This Sound Familiar? Introduction Need ?? min Ask
9. Unbalanced Message Can Lead to Confusion — Like a System Failure
10. Simple Diagrams Can Make Our Communication More Reliable
11. The Mechanism of Communication Failures
12. Anatomy of Communication Failures 1.Conceptualization
13. Anatomy of Communication Failures Transpiler (EN) Text 1.Conceptualization 2.Encode
14. Anatomy of Communication Failures Transpiler (EN) Text Transpiler (EN) 1.Conceptualization 2.Encode 3.Decode → Ask Something →
15. Anatomy of Communication Failures Transpiler (EN) Text Transpiler (EN) 1.Conceptualization 2.Encode 3.Decode 4.Mental Imagery → Ask Something →
16. Anatomy of Communication Failures Transpiler (EN) Text Transpiler (EN) 1.Conceptualization 2.Encode 3.Decode 4.Mental Imagery → Ask Something →
17. Anatomy of Communication Failures Transpiler (EN) Text Transpiler (EN) 1.Conceptualization 2.Encode 3.Decode 4.Mental Imagery Transpiler (JA) もじ Transpiler (JA) Success rate: 0.9 Success rate: 0.9 Success rate: 0.9 Success rate: 0.9 Overall success rate: 0.66 (0.9^4)
18. Anatomy of Communication Failures Transpiler (EN) Text Transpiler (EN) 1.Conceptualization 2.Encode 3.Decode 4.Mental Imagery Things get worse when we work with unwell known teams
19. How about using a diagram together?
20. • Visualizing Self-Understanding • Skipping the Thought-to-Language Step • Ensuring Redundancy 3 Effects for Communication Reliability Visual Communication
21. 3 Effects for Improved Reliability Effect 1: Visualizing Self-Understanding ? ???
22. 3 Effects for Improved Reliability Effect 2: Skipping the Thought-to-Language Step Success rate: 0.9 Success rate: 0.9 Transpiler (EN) Text Transpiler (EN) Overall success rate: 0.81 Skip Skip
23. 3 Effects for Improved Reliability Effect 3: Ensuring Redundancy Transpiler (EN) Text Transpiler (EN)
24. That's a nice idea, but is it practical…?
25. • Not knowing what to draw • Creating diagrams takes time Common Concerns
26. Concern 1: Not Knowing What to Draw
27. Asking Is Simple — Just 4 Elements
28. What to Draw: 4 Essentials Concern 1: Not Knowing What to Draw Purpose As Is To Be How What’s our ultimate goal?
29. What to Draw: 4 Essentials Concern 1: Not Knowing What to Draw Purpose As Is To Be How What’s our ultimate goal? What’s the ideal situation?
30. What’s the current status? What to Draw: 4 Essentials Concern 1: Not Knowing What to Draw Purpose As Is To Be How What’s our ultimate goal? What’s the ideal situation?
31. What’s the current status? What to Draw: 4 Essentials Concern 1: Not Knowing What to Draw Purpose As Is To Be How What’s our ultimate goal? How do we achieve it? What’s the ideal situation?
32. What’s the current status? When Asking a Question Concern 1: Not Knowing What to Draw Purpose As Is To Be ? What’s our ultimate goal? Need help with this part What’s the ideal situation?
33. A Classic Case of Communication Failure
34. A Classic Case of Communication Failure I want to fix an error in CI. We're getting a permission error. Other team My team
35. A Classic Case of Communication Failure I want to fix an error in CI. We're getting a permission error. ???
36. A Classic Case of Communication Failure I want to fix an error in CI. We're getting a permission error. ??? • What are you trying to do? • Which AWS account? • What does your system look like? • etc…
37. A Classic Case of Communication Failure I want to fix an error in CI. We're getting a permission error. Invest 60 min They wanted to deploy frontend assets to S3 using GitHub Actions but didn't know how to set up OIDC authentication correctly.
38. Let's Break Down Their Request!
39. Trying to push from GitHub repository to S3, but getting permission errors Purpose As Is To Be To distribute frontend assets Push assets to S3 with GitHub Actions How Don't know how to set up correct Role
40. System architecture (ToBe)
41. What If This Diagram Was Shared from the Start?
42. This Could Have Taken Just 5 Minutes
43. Let’s Improve This Diagram more!
44. Purpose: To distribute frontend assets To Be As Is But getting permission error Push assets to S3 Improvement: Put a system architecture
45. Purpose: To distribute frontend assets Improvement: Merge two diagrams
46. Purpose: To distribute frontend assets Actual status Desired status Improvement: Use two types line
47. Purpose: To distribute frontend assets Actual status Desired status Error: xxx permission denied. But we don’t know why… Improvement: Add messages
48. Concern 2: Creating Diagrams Takes Time
49. Yes, it does take time.
50. But let’s think about the total time for everyone.
51. Concern 2: Creating Diagrams Takes Time Common concerns Invest 30 min Reduce 30 min VS A fair trade!! → Ask Something → Text ＋
52. Concern 2: Creating Diagrams Takes Time Common concerns Invest 30 min Reduce 60 min VS → Ask Something → Text ＋ A good deal!!
53. Concern 2: Creating Diagrams Takes Time Common concerns Invest 30 min Reduce 150 min VS → Ask Something → Text ＋ − 30 min − 30 min − 30 min − 30 min − 30 min A great value!!
54. Let’s Respect Their Time — and Save It.
55. Conclusion
56. Three Core Values of Visual Communication • Helping yourself understand better • Helping everyone understand quickly — even across language barriers • Saving time for everyone Conclusion
57. One Step to Start Tomorrow Conclusion What’s the current status? Purpose As Is To Be How What’s our ultimate goal? How do we achieve it? What’s the ideal situation?
58. One Steps to Start Tomorrow Actual status Desired status Error: xxx permission denied. But we don’t know why… Conclusion
59. Let’s Keep Our Communication Reliability Through Drawings!