├── CNAME ├── .gitignore ├── assets ├── compatcover.png ├── figures │ ├── copa_0101.png │ ├── copa_0102.png │ ├── copa_0103.png │ ├── copa_0104.png │ ├── copa_0105.png │ ├── copa_0106.png │ ├── copa_0107.png │ ├── copa_0108.png │ ├── copa_0109.png │ ├── copa_0110.png │ ├── copa_0111.png │ ├── copa_0112.png │ ├── copa_0201.png │ ├── copa_0202.png │ ├── copa_0203.png │ ├── copa_0204.png │ ├── copa_0205.png │ ├── copa_0206.png │ ├── copa_0207.png │ ├── copa_0208.png │ ├── copa_0301.png │ ├── copa_0302.png │ ├── copa_0303.png │ ├── copa_0304.png │ ├── copa_0305.png │ ├── copa_0306.png │ ├── copa_0307.png │ ├── copa_0308.png │ ├── copa_0401.png │ ├── copa_0402.png │ ├── copa_0403.png │ ├── copa_0404.png │ ├── copa_0405.png │ ├── copa_0406.png │ ├── copa_0407.png │ ├── copa_0408.png │ ├── copa_0409.png │ ├── copa_0501.png │ ├── copa_0502.png │ ├── copa_0503.png │ ├── copa_0504.png │ ├── copa_0505.png │ ├── copa_0506.png │ ├── copa_0507.png │ ├── copa_0508.png │ ├── copa_0509.png │ ├── copa_0601.png │ ├── copa_0602.png │ ├── copa_0603.png │ ├── copa_0604.png │ ├── copa_0605.png │ ├── copa_0606.png │ ├── copa_0607.png │ ├── copa_0608.png │ ├── copa_0609.png │ ├── copa_0610.png │ ├── copa_0611.png │ ├── copa_0612.png │ ├── copa_0613.png │ ├── copa_0614.png │ ├── copa_0615.png │ ├── copa_0616.png │ ├── copa_0617.png │ ├── copa_0701.png │ ├── copa_0801.png │ ├── copa_0802.png │ ├── copa_0901.png │ ├── copa_1001.png │ ├── copa_1002.png │ ├── copa_1003.png │ ├── copa_1004.png │ ├── copa_1005.png │ ├── copa_1101.png │ ├── copa_1102.png │ ├── copa_1201.png │ ├── copa_1202.png │ ├── copa_1203.png │ ├── copa_1204.png │ ├── copa_1205.png │ ├── copa_1206.png │ ├── copa_1207.png │ ├── copa_1301.png │ ├── copa_1302.png │ ├── copa_1401.png │ ├── copa_1501.png │ ├── copa_1502.png │ ├── copa_1503.png │ └── copa_1504.png ├── Mastodon-Logo-wikimedia.svg ├── ADR-example.md ├── ADR-template.md ├── css │ └── style.scss ├── reshot-icon-linkedin.svg ├── ADR-example-decision-making.md └── reshot-icon-internet-col.svg ├── _config.yml ├── bonuses.md ├── figures.md ├── README.md └── LICENSE /CNAME: -------------------------------------------------------------------------------- 1 | communicationpatternsbook.com -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | # environment 2 | .vscode/ 3 | .DS_Store 4 | -------------------------------------------------------------------------------- /assets/compatcover.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/compatcover.png -------------------------------------------------------------------------------- /assets/figures/copa_0101.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0101.png -------------------------------------------------------------------------------- /assets/figures/copa_0102.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0102.png -------------------------------------------------------------------------------- /assets/figures/copa_0103.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0103.png -------------------------------------------------------------------------------- /assets/figures/copa_0104.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0104.png -------------------------------------------------------------------------------- /assets/figures/copa_0105.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0105.png -------------------------------------------------------------------------------- /assets/figures/copa_0106.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0106.png -------------------------------------------------------------------------------- /assets/figures/copa_0107.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0107.png -------------------------------------------------------------------------------- /assets/figures/copa_0108.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0108.png -------------------------------------------------------------------------------- /assets/figures/copa_0109.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0109.png -------------------------------------------------------------------------------- /assets/figures/copa_0110.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0110.png -------------------------------------------------------------------------------- /assets/figures/copa_0111.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0111.png -------------------------------------------------------------------------------- /assets/figures/copa_0112.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0112.png -------------------------------------------------------------------------------- /assets/figures/copa_0201.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0201.png -------------------------------------------------------------------------------- /assets/figures/copa_0202.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0202.png -------------------------------------------------------------------------------- /assets/figures/copa_0203.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0203.png -------------------------------------------------------------------------------- /assets/figures/copa_0204.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0204.png -------------------------------------------------------------------------------- /assets/figures/copa_0205.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0205.png -------------------------------------------------------------------------------- /assets/figures/copa_0206.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0206.png -------------------------------------------------------------------------------- /assets/figures/copa_0207.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0207.png -------------------------------------------------------------------------------- /assets/figures/copa_0208.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0208.png -------------------------------------------------------------------------------- /assets/figures/copa_0301.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0301.png -------------------------------------------------------------------------------- /assets/figures/copa_0302.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0302.png -------------------------------------------------------------------------------- /assets/figures/copa_0303.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0303.png -------------------------------------------------------------------------------- /assets/figures/copa_0304.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0304.png -------------------------------------------------------------------------------- /assets/figures/copa_0305.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0305.png -------------------------------------------------------------------------------- /assets/figures/copa_0306.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0306.png -------------------------------------------------------------------------------- /assets/figures/copa_0307.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0307.png -------------------------------------------------------------------------------- /assets/figures/copa_0308.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0308.png -------------------------------------------------------------------------------- /assets/figures/copa_0401.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0401.png -------------------------------------------------------------------------------- /assets/figures/copa_0402.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0402.png -------------------------------------------------------------------------------- /assets/figures/copa_0403.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0403.png -------------------------------------------------------------------------------- /assets/figures/copa_0404.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0404.png -------------------------------------------------------------------------------- /assets/figures/copa_0405.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0405.png -------------------------------------------------------------------------------- /assets/figures/copa_0406.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0406.png -------------------------------------------------------------------------------- /assets/figures/copa_0407.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0407.png -------------------------------------------------------------------------------- /assets/figures/copa_0408.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0408.png -------------------------------------------------------------------------------- /assets/figures/copa_0409.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0409.png -------------------------------------------------------------------------------- /assets/figures/copa_0501.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0501.png -------------------------------------------------------------------------------- /assets/figures/copa_0502.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0502.png -------------------------------------------------------------------------------- /assets/figures/copa_0503.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0503.png -------------------------------------------------------------------------------- /assets/figures/copa_0504.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0504.png -------------------------------------------------------------------------------- /assets/figures/copa_0505.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0505.png -------------------------------------------------------------------------------- /assets/figures/copa_0506.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0506.png -------------------------------------------------------------------------------- /assets/figures/copa_0507.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0507.png -------------------------------------------------------------------------------- /assets/figures/copa_0508.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0508.png -------------------------------------------------------------------------------- /assets/figures/copa_0509.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0509.png -------------------------------------------------------------------------------- /assets/figures/copa_0601.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0601.png -------------------------------------------------------------------------------- /assets/figures/copa_0602.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0602.png -------------------------------------------------------------------------------- /assets/figures/copa_0603.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0603.png -------------------------------------------------------------------------------- /assets/figures/copa_0604.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0604.png -------------------------------------------------------------------------------- /assets/figures/copa_0605.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0605.png -------------------------------------------------------------------------------- /assets/figures/copa_0606.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0606.png -------------------------------------------------------------------------------- /assets/figures/copa_0607.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0607.png -------------------------------------------------------------------------------- /assets/figures/copa_0608.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0608.png -------------------------------------------------------------------------------- /assets/figures/copa_0609.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0609.png -------------------------------------------------------------------------------- /assets/figures/copa_0610.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0610.png -------------------------------------------------------------------------------- /assets/figures/copa_0611.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0611.png -------------------------------------------------------------------------------- /assets/figures/copa_0612.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0612.png -------------------------------------------------------------------------------- /assets/figures/copa_0613.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0613.png -------------------------------------------------------------------------------- /assets/figures/copa_0614.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0614.png -------------------------------------------------------------------------------- /assets/figures/copa_0615.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0615.png -------------------------------------------------------------------------------- /assets/figures/copa_0616.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0616.png -------------------------------------------------------------------------------- /assets/figures/copa_0617.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0617.png -------------------------------------------------------------------------------- /assets/figures/copa_0701.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0701.png -------------------------------------------------------------------------------- /assets/figures/copa_0801.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0801.png -------------------------------------------------------------------------------- /assets/figures/copa_0802.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0802.png -------------------------------------------------------------------------------- /assets/figures/copa_0901.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_0901.png -------------------------------------------------------------------------------- /assets/figures/copa_1001.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_1001.png -------------------------------------------------------------------------------- /assets/figures/copa_1002.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_1002.png -------------------------------------------------------------------------------- /assets/figures/copa_1003.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_1003.png -------------------------------------------------------------------------------- /assets/figures/copa_1004.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_1004.png -------------------------------------------------------------------------------- /assets/figures/copa_1005.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_1005.png -------------------------------------------------------------------------------- /assets/figures/copa_1101.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_1101.png -------------------------------------------------------------------------------- /assets/figures/copa_1102.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_1102.png -------------------------------------------------------------------------------- /assets/figures/copa_1201.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_1201.png -------------------------------------------------------------------------------- /assets/figures/copa_1202.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_1202.png -------------------------------------------------------------------------------- /assets/figures/copa_1203.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_1203.png -------------------------------------------------------------------------------- /assets/figures/copa_1204.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_1204.png -------------------------------------------------------------------------------- /assets/figures/copa_1205.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_1205.png -------------------------------------------------------------------------------- /assets/figures/copa_1206.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_1206.png -------------------------------------------------------------------------------- /assets/figures/copa_1207.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_1207.png -------------------------------------------------------------------------------- /assets/figures/copa_1301.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_1301.png -------------------------------------------------------------------------------- /assets/figures/copa_1302.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_1302.png -------------------------------------------------------------------------------- /assets/figures/copa_1401.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_1401.png -------------------------------------------------------------------------------- /assets/figures/copa_1501.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_1501.png -------------------------------------------------------------------------------- /assets/figures/copa_1502.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_1502.png -------------------------------------------------------------------------------- /assets/figures/copa_1503.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_1503.png -------------------------------------------------------------------------------- /assets/figures/copa_1504.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tekiegirl/communicationpatterns/HEAD/assets/figures/copa_1504.png -------------------------------------------------------------------------------- /_config.yml: -------------------------------------------------------------------------------- 1 | remote_theme: pages-themes/cayman@v0.2.0 2 | plugins: 3 | - jekyll-remote-theme 4 | 5 | title: Communication Patterns 6 | show_downloads: false 7 | -------------------------------------------------------------------------------- /bonuses.md: -------------------------------------------------------------------------------- 1 | # Bonus Material 2 | 3 | ## ADR (Architecture Decision Records) 4 | Here are some examples and a template for creating ADRs. Licenses are specified on individual files. 5 | - [ADR Example](assets/ADR-example.md) [[markdown]](https://raw.githubusercontent.com/tekiegirl/communicationpatterns/main/assets/ADR-example.md): for general use. 6 | - [ADR Decision-Making Example](assets/ADR-example-decision-making.md) [[markdown]](https://raw.githubusercontent.com/tekiegirl/communicationpatterns/main/assets/ADR-example-decision-making.md): use this to augment and structure the decision-making process. 7 | - [ADR Template](assets/ADR-template.md) [[markdown]](https://raw.githubusercontent.com/tekiegirl/communicationpatterns/main/assets/ADR-template.md): headings with details of what should be included under each. 8 | 9 | [> Home](README.md) -------------------------------------------------------------------------------- /assets/Mastodon-Logo-wikimedia.svg: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | -------------------------------------------------------------------------------- /assets/ADR-example.md: -------------------------------------------------------------------------------- 1 | [> Home](README.md) | [> Bonuses](bonuses.md) 2 | 3 | # ADR-044 Change to Event-Driven Architecture 4 | 5 | ## Status 6 | Decided, 2023-10-04 7 | Supersedes [ADR-031 Use serverless functions](https://link-to-superseded-ADR) 8 | 9 | ## Context 10 | The Polyglot Media system is currently a distributed system consisting mostly of serverless functions. Moving from a monolith to a distributed serverless architecture was done to tackle problems with the responsiveness of the live system and a long lead time between functionality and bug fixes being coded and deployed to production. 11 | 12 | Serverless architecture has not solved the problems with responsiveness or maintainability to the degree required, with functions being tightly coupled with many other functions. 13 | 14 | A solution to the problems of responsiveness and time-to-market must be found. 15 | 16 | ## Decision 17 | We will use event-driven architecture due to its responsiveness and scalability, and the limited tradeoffs compared to the other two options. Event-driven also scores the highest of the three options on the most important criterion: responsiveness. 18 | 19 | ## Implications 20 | ### Positive 21 | - We gain overall higher responsiveness, maintainability, and scalability than the current serverless functions. 22 | - Processing of events is scalable by spinning up additional instances of services to process queued events. 23 | - Processing within services is scalable by spinning up additional instances of services to handle the need for processing within the services. 24 | 25 | ### Negative 26 | - Teams or individuals may need to learn new skills or technologies (such as event queues). 27 | - Event management (such as queues) adds extra complexity to development and deployment. 28 | - Integration testing and DevOps will need to be overhauled. 29 | 30 | LICENSE: [CC BY 4.0 (Jacqui Read / jacquiread.com)](https://creativecommons.org/licenses/by/4.0/). 31 | 32 | [> Home](README.md) | [> Bonuses](bonuses.md) -------------------------------------------------------------------------------- /assets/ADR-template.md: -------------------------------------------------------------------------------- 1 | [> Home](README.md) | [> Bonuses](bonuses.md) 2 | 3 | # Identifier and Title (a statement of the decision made) 4 | 5 | ## Status 6 | Draft/Decided/Superseded by ADR-XXX 7 | 8 | ## Context 9 | Why you need to make the decision. Assumptions, constraints, and decision drivers. 10 | 11 | ## Evaluation Criteria 12 | What is important to you in making this decision? 13 | Which of your architectural characteristics apply to making this decision? 14 | Should any constraints or decision-drivers become a criterion? 15 | 16 | ## Options 17 | Outlines of the options considered against the evaluation criteria (usually using a 18 | score or rating), and trade-offs outside of the evaluation criteria. A template for a comparison table is included below. 19 | 20 | ### 1. First option 21 | 22 | | Criteria | Score | Rationale | 23 | | ---------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------- | 24 | | Criteria 1 | ★★★☆☆ 3/5 | Rationale for score 1 with optional [link to reference](https://link-to-reference) | 25 | | Criteria 2 | ★★★☆☆ 3/5 | Rationale for score 2 | 26 | | Criteria 3 | ★★★★★ 5/5 | Rationale for score 3 | 27 | | Criteria n | ★★★★★ 5/5 | Rationale for score n | 28 | | | **Total:** 16/20 | **Other Trade-offs** | 29 | | | | - Extra tradeoff 1 with optional [link to reference](https://link-to-reference)
- Extra tradeoff 2
- Extra tradeoff n | 30 | 31 | ## Decision 32 | The choice that was made and why. 33 | 34 | ## Implications 35 | The positive and negative consequences of the decision made. 36 | 37 | ## Consultation 38 | If taking input from others, they should document it here. Details of those invited 39 | to give input can be recorded, whether they provide input or not. Although consultation 40 | takes place before a decision, it is documented at the end because it can become 41 | long and obscure the decision itself. 42 | 43 | [> Home](README.md) | [> Bonuses](bonuses.md) -------------------------------------------------------------------------------- /assets/css/style.scss: -------------------------------------------------------------------------------- 1 | --- 2 | --- 3 | 4 | @import "{{ site.theme }}"; 5 | .page-header { 6 | background-image: linear-gradient(to right, #8F6374 0%, 33.95061728395061%, #D3752C 50.729517396184065%, 74.80359147025814%, #A4AA3F 100%); 7 | padding: 1rem 6rem; 8 | } 9 | table, tr, td, th { 10 | border: none; 11 | } 12 | .after-contact{ 13 | margin-top: 2.5em; 14 | clear: left; 15 | } 16 | .contact div { 17 | float: left; 18 | margin: 5px; 19 | display: table; 20 | } 21 | .contact div span img { 22 | height: 1.3em; 23 | vertical-align: middle; 24 | display: table-cell; 25 | margin-right: 5px; 26 | } 27 | .contact div span { 28 | vertical-align: middle; 29 | display: table-cell; 30 | } 31 | .main-content h1, .main-content h2, .main-content h3, .main-content h4, .main-content h5, .main-content h6 { 32 | color: #8f6374; 33 | } 34 | 35 | /* for quote carousel */ 36 | $animation-timing: 170s; 37 | $carousel-items: 17; 38 | $animation-delay-fraction: $animation-timing / $carousel-items; 39 | $animation-steps-fraction: 100 / $carousel-items; 40 | $slide-change-timing: 1; // percentage of total animation cycle 41 | 42 | *, *::before, *::after { 43 | box-sizing: border-box; 44 | } 45 | 46 | body { 47 | font-family: 'Work Sans', sans-serif; 48 | font-weight: 400; 49 | height: 100vh; 50 | } 51 | 52 | .wrapper { 53 | background: linear-gradient(to right, #8F6374 0%, 33.95061728395061%, #D3752C 50.729517396184065%, 74.80359147025814%, #A4AA3F 100%); 54 | height: 100%; 55 | width: 100%; 56 | display: flex; 57 | justify-content: center; 58 | min-height: 450px; 59 | } 60 | 61 | .carousel { 62 | position: relative; 63 | width: 100%; 64 | max-width: 800px; 65 | display: flex; 66 | justify-content: center; 67 | flex-direction: column; 68 | overflow: hidden; 69 | } 70 | 71 | .carousel__item { 72 | display: flex; 73 | align-items: center; 74 | position: absolute; 75 | width: 100%; 76 | padding: 0 12px; 77 | opacity: 0; 78 | filter: drop-shadow(0 2px 2px #555); 79 | will-change: transform, opacity; 80 | animation: carousel-animate-vertical $animation-timing linear infinite; 81 | } 82 | 83 | @for $i from 1 through ($carousel-items - 1) { 84 | .carousel__item:nth-child(#{$i}) { 85 | animation-delay: calc(#{$animation-delay-fraction} * #{$i - 2}); 86 | } 87 | } 88 | 89 | .carousel__item:last-child { 90 | animation-delay: calc(-#{$animation-delay-fraction} * 2); 91 | } 92 | 93 | .carousel__item-head { 94 | border-radius: 50%; 95 | background-color: #d7f7fc; 96 | width: 90px; 97 | height: 90px; 98 | padding: 14px; 99 | position: relative; 100 | margin-right: -45px; 101 | flex-shrink: 0; 102 | display: flex; 103 | align-items: center; 104 | justify-content: center; 105 | font-size: 50px; 106 | } 107 | 108 | .carousel__item-body { 109 | width: 100%; 110 | background-color: #fff; 111 | border-radius: 8px; 112 | padding: 16px 20px 16px 70px; 113 | } 114 | 115 | .title { 116 | text-transform: uppercase; 117 | font-size: 20px; 118 | margin-top: 10px; 119 | } 120 | 121 | .subtitle { 122 | text-transform: uppercase; 123 | font-size: 14px; 124 | margin-top: -20px; 125 | } 126 | 127 | .quote { 128 | margin-block-start: 0px; 129 | margin-block-end: 0px; 130 | line-height: 2px; 131 | font-size: 3em; 132 | margin-top: 30px; 133 | margin-bottom: -18px !important; 134 | padding-bottom: 0px; 135 | } 136 | 137 | .right { 138 | text-align: right; 139 | padding-top: 3px; 140 | margin-top: 0; 141 | margin-bottom: 0 !important; 142 | } 143 | 144 | .qtext { 145 | padding-left: 15px; 146 | padding-right: 12px; 147 | } 148 | 149 | @keyframes carousel-animate-vertical { 150 | 0% { 151 | transform: translateY(100%) scale(0.5); 152 | opacity: 0; 153 | visibility: hidden; 154 | } 155 | #{$slide-change-timing}%, 156 | #{$animation-steps-fraction}% { 157 | transform: translateY(100%) scale(0.7); 158 | opacity: .4; 159 | visibility: visible; 160 | } 161 | #{$animation-steps-fraction + $slide-change-timing}%, 162 | #{$animation-steps-fraction * 2}% { 163 | transform: translateY(0) scale(1); 164 | opacity: 1; 165 | visibility: visible; 166 | } 167 | #{($animation-steps-fraction * 2) + $slide-change-timing}%, 168 | #{$animation-steps-fraction * 3}% { 169 | transform: translateY(-100%) scale(0.7); 170 | opacity: .4; 171 | visibility: visible; 172 | } 173 | #{($animation-steps-fraction * 3) + $slide-change-timing}% { 174 | transform: translateY(-100%) scale(0.5); 175 | opacity: 0; 176 | visibility: visible; 177 | } 178 | 100% { 179 | transform: translateY(-100%) scale(0.5); 180 | opacity: 0; 181 | visibility: hidden; 182 | } 183 | } 184 | /* end quote carousel */ 185 | 186 | /* for LinkedIn */ 187 | .libutton { 188 | display: flex; 189 | flex-direction: column; 190 | justify-content: center; 191 | padding: 7px; 192 | text-align: center; 193 | outline: none; 194 | text-decoration: none !important; 195 | color: #ffffff !important; 196 | width: 200px; 197 | height: 32px; 198 | border-radius: 16px; 199 | background-color: #0A66C2; 200 | font-family: "SF Pro Text", Helvetica, sans-serif; 201 | } 202 | /* end LinkedIn */ -------------------------------------------------------------------------------- /assets/reshot-icon-linkedin.svg: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 6 | 7 | 8 | 9 | 15 | 16 | 17 | license|no attribution required 18 | use|icon 19 | colours|colour 20 | 21 | 22 | 23 | 24 | no attribution required 25 | icon 26 | colour 27 | 28 | 29 | 2023-11-28T14:43:26Z 30 | xmp.iid:1468052c-c70c-4ae1-b934-bfb41b65053b 31 | xmp.did:d96fb03e-6100-497e-ab8a-a99e260ffa11 32 | xmp.did:d96fb03e-6100-497e-ab8a-a99e260ffa11 33 | 34 | 35 | 36 | 37 | saved 38 | xmp.iid:d96fb03e-6100-497e-ab8a-a99e260ffa11 39 | 2023-11-28T14:29:39Z 40 | Adobe Bridge 2024 41 | /metadata 42 | 43 | 44 | 45 | 46 | saved 47 | xmp.iid:1468052c-c70c-4ae1-b934-bfb41b65053b 48 | 2023-11-28T14:43:26Z 49 | Adobe Bridge 2024 50 | /metadata 51 | 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59 | 60 | 61 | 62 | 63 | 64 | 65 | 66 | 67 | 68 | 69 | 70 | 71 | 72 | 73 | 94 | 95 | -------------------------------------------------------------------------------- /assets/ADR-example-decision-making.md: -------------------------------------------------------------------------------- 1 | [> Home](README.md) | [> Bonuses](bonuses.md) 2 | 3 | # ADR-044 Use an Event-Driven Distributed Architecture 4 | 5 | ## Status 6 | Decided, 2023-10-04 7 | Supersedes [ADR-031 Use serverless functions](https://link-to-superseded-ADR) 8 | 9 | ## Context 10 | The Polyglot Media system is currently a distributed system consisting mostly of serverless functions. Moving from a monolith to a distributed serverless architecture was done to tackle problems with the responsiveness of the live system and a long lead time between functionality and bug fixes being coded and deployed to production. 11 | 12 | Serverless architecture has not solved the problems with responsiveness or maintainability to the degree required, with functions being tightly coupled with many other functions. 13 | 14 | A solution to the problems of responsiveness and time-to-market must be found. 15 | 16 | ## Evaluation Criteria 17 | See [ADR-002 Select Architecture Characteristics](https://link-to-ADR-002) 18 | 19 | - _Responsiveness_: Customers have been complaining about the responsiveness of the system, and this must be addressed. This is deemed the most important criterion. 20 | - _Maintainability_: The serverless functions improved the time-to-market of bug fixes and new functionality but not to the extent needed. 21 | - _Deployability_: Alongside maintainability, deployability is important to improve time-to-market for bug fixes and new functionality. 22 | - _Scalability_: Most complaints from customers about responsiveness have been around peak use times, so the system must handle peak numbers of users without impacting users. 23 | 24 | ## Options 25 | ### 1. Microservices 26 | 27 | | Criteria | Score | Rationale | 28 | | --------------- | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | 29 | | Responsiveness | ★★★☆☆ 3/5 | [Not inherently performant](https://link-to-reference-info) but optimisations can be put in place at bottlenecks, e.g. scaling | 30 | | Maintainability | ★★★☆☆ 3/5 | Dependencies can be an issue, many data stores to maintain | 31 | | Deployability | ★★★★★ 5/5 | Deploy only what has changed | 32 | | Scalability | ★★★★★ 5/5 | Scale on per-service basis | 33 | | | **Total:** 16/20 | **Other Trade-offs** | 34 | | | | - Must split data into [one data store per service](https://link-to-reference-info)
- Costs are usually high for building
- Complex and is hard to create workflows | 35 | 36 | ### 2. Service-based 37 | 38 | | Criteria | Score | Rationale | 39 | | --------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------ | 40 | | Responsiveness | ★★★☆☆ 3/5 | [Not inherently performant](https://link-to-reference-info) but optimisations can be put in place at bottlenecks, e.g. scaling | 41 | | Maintainability | ★★★★☆ 4/5 | Fewer data stores to maintain than microservices | 42 | | Deployability | ★★★★☆ 4/5 | Deploy only what has changed, make sure changes to shared data store(s) don't affect other services | 43 | | Scalability | ★★★☆☆ 3/5 | Scale individual services, harder to scale shared data store(s) unless using [caching](https://link-to-reference-info) | 44 | | | **Total:** 14/20 | **Other Trade-offs** | 45 | | | | - Reasonably complex & hard to create workflows
- Not as evolvable as microservices | 46 | 47 | ### 3. Event-driven 48 | 49 | | Criteria | Score | Rationale | 50 | | --------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------- | 51 | | Responsiveness | ★★★★★ 5/5 | Generally [fire-and-forget](https://link-to-reference-info), event processing can be scaled/optimised | 52 | | Maintainability | ★★★★☆ 4/5 | Must manage event processing as well as services and data stores, events decouple services to be managed by individual teams | 53 | | Deployability | ★★★☆☆ 3/5 | Manage event processing deployment and changes as well as services | 54 | | Scalability | ★★★★★ 5/5 | Services and message processing can both be scaled | 55 | | | **Total:** 17/20 | **Other Trade-offs** | 56 | | | | - [Integration testing can be harder](https://link-to-reference-info) | 57 | 58 | ## Decision 59 | We will use event-driven architecture due to its responsiveness and scalability, and the limited tradeoffs compared to the other two options. Event-driven also scores the highest of the three options on the most important criterion: responsiveness. 60 | 61 | ## Implications 62 | ### Positive 63 | - We gain overall higher responsiveness, maintainability, and scalability than the current serverless functions. 64 | - Processing of events is scalable by spinning up additional instances of services to process queued events. 65 | - Processing within services is scalable by spinning up additional instances of services to handle the need for processing within the services. 66 | 67 | ### Negative 68 | - Teams or individuals may need to learn new skills or technologies (such as event queues). 69 | - Event management (such as queues) adds extra complexity to development and deployment. 70 | - Integration testing and DevOps will need to be overhauled. 71 | 72 | ## Consultation 73 | - _Vlad_: Neither microservices nor service-based are [inherently performant](https://link-to-reference-info), so likely will not boost responsiveness as much as we want. 74 | - _Nikki_: I have experience in event-driven architecture, using queues. We monitored the length of queues and spun up extra instances of services to process long queues when needed. 75 | - _Libby_: Queues and channels can be used to prioritise the processing of events, for example with the [ambulance pattern](https://link-to-reference-info). 76 | - _Mark_: Responsiveness needs to be the top priority due to customer complaints. 77 | - _Libby_: Pure microservices would require that services do not share data stores. Splitting our data like this would require a lot of effort. 78 | 79 | LICENSE: [CC BY 4.0 (Jacqui Read / jacquiread.com)](https://creativecommons.org/licenses/by/4.0/). 80 | 81 | [> Home](README.md) | [> Bonuses](bonuses.md) -------------------------------------------------------------------------------- /assets/reshot-icon-internet-col.svg: -------------------------------------------------------------------------------- 1 | 2 | 20 | 22 | 41 | 13-www 43 | 45 | 47 | 48 | 49 | 51 | 52 | 53 | 13-www 55 | 56 | 57 | 58 | 59 | no attribution required 60 | icon 61 | black and white 62 | 63 | 64 | 65 | 66 | license|no attribution required 67 | use|icon 68 | colours|black and white 69 | 70 | 71 | 2023-11-28T14:38:56Z 72 | xmp.iid:44b5e7d1-29c9-4a57-a933-26ac73c7418f 73 | xmp.did:15098f02-d3e1-4d8d-a864-a98bd6681ea7 74 | xmp.did:15098f02-d3e1-4d8d-a864-a98bd6681ea7 75 | 76 | 77 | 78 | 79 | saved 80 | xmp.iid:15098f02-d3e1-4d8d-a864-a98bd6681ea7 81 | 2023-11-28T14:29:39Z 82 | Adobe Bridge 2024 83 | /metadata 84 | 85 | 86 | 87 | 88 | saved 89 | xmp.iid:44b5e7d1-29c9-4a57-a933-26ac73c7418f 90 | 2023-11-28T14:38:56Z 91 | Adobe Bridge 2024 92 | /metadata 93 | 94 | 95 | 96 | 97 | 98 | 100 | 13-www 101 | 102 | 103 | 104 | 105 | 106 | 110 | 114 | 121 | 128 | 135 | 139 | 146 | 153 | 160 | 164 | 168 | 172 | 176 | 180 | 184 | 191 | 198 | 205 | 209 | 216 | 217 | 218 | -------------------------------------------------------------------------------- /figures.md: -------------------------------------------------------------------------------- 1 | # Figures 2 | [> Home](README.md) 3 | 4 | All images are licensed as [CC BY 4.0 (Jacqui Read / jacquiread.com)](https://creativecommons.org/licenses/by/4.0/) 5 | 6 | 7 | 8 | ## Contents 9 | ### Part I 10 | - Chapter 1 11 | - Chapter 2 12 | - Chapter 3 13 | - Chapter 4 14 | - Chapter 5 15 | - Chapter 6 16 | 17 | ### Part II 18 | - Chapter 7 19 | - Chapter 8 20 | - Chapter 9 21 | 22 | ### Part III 23 | - Chapter 10 24 | - Chapter 11 25 | - Chapter 12 26 | 27 | ### Part IV 28 | - Chapter 13 29 | - Chapter 14 30 | - Chapter 15 31 | 32 | 33 | 34 | ## Chapter 1 35 | 36 | 37 | 38 | ### Fig 1-1 39 | 40 | 41 | 42 | 43 | ### Fig 1-2 44 | 45 | 46 | 47 | 48 | ### Fig 1-3 49 | 50 | 51 | 52 | 53 | ### Fig 1-4 54 | 55 | 56 | 57 | 58 | ### Fig 1-5 59 | 60 | 61 | 62 | 63 | ### Fig 1-6 64 | 65 | 66 | 67 | 68 | ### Fig 1-7 69 | 70 | 71 | 72 | 73 | ### Fig 1-8 74 | 75 | 76 | 77 | 78 | ### Fig 1-9 79 | 80 | 81 | 82 | 83 | ### Fig 1-10 84 | 85 | 86 | 87 | 88 | ### Fig 1-11 89 | 90 | 91 | 92 | 93 | ### Fig 1-12 94 | 95 | 96 | ^ contents 97 | 98 | 99 | 100 | ## Chapter 2 101 | ### Fig 2-1 102 | 103 | 104 | ### Fig 2-2 105 | 106 | 107 | ### Fig 2-3 108 | 109 | 110 | ### Fig 2-4 111 | 112 | 113 | ### Fig 2-5 114 | 115 | 116 | ### Fig 2-6 117 | 118 | 119 | ### Fig 2-7 120 | 121 | 122 | ### Fig 2-8 123 | 124 | 125 | ^ contents 126 | 127 | 128 | 129 | ## Chapter 3 130 | ### Fig 3-1 131 | 132 | 133 | ### Fig 3-2 134 | 135 | 136 | ### Fig 3-3 137 | 138 | 139 | ### Fig 3-4 140 | 141 | 142 | ### Fig 3-5 143 | 144 | 145 | ### Fig 3-6 146 | 147 | 148 | ### Fig 3-7 149 | 150 | 151 | ### Fig 3-8 152 | 153 | 154 | ^ contents 155 | 156 | 157 | 158 | ## Chapter 4 159 | ### Fig 4-1 160 | 161 | 162 | ### Fig 4-2 163 | 164 | 165 | ### Fig 4-3 166 | 167 | 168 | ### Fig 4-4 169 | 170 | 171 | ### Fig 4-5 172 | 173 | 174 | ### Fig 4-6 175 | 176 | 177 | ### Fig 4-7 178 | 179 | 180 | ### Fig 4-8 181 | 182 | 183 | ### Fig 4-9 184 | 185 | 186 | ^ contents 187 | 188 | 189 | 190 | ## Chapter 5 191 | ### Fig 5-1 192 | 193 | 194 | ### Fig 5-2 195 | 196 | 197 | ### Fig 5-3 198 | 199 | 200 | ### Fig 5-4 201 | 202 | 203 | ### Fig 5-5 204 | 205 | 206 | ### Fig 5-6 207 | 208 | 209 | ### Fig 5-7 210 | 211 | 212 | ### Fig 5-8 213 | 214 | 215 | ### Fig 5-9 216 | 217 | 218 | ^ contents 219 | 220 | 221 | 222 | ## Chapter 6 223 | ### Fig 6-1 224 | 225 | 226 | ### Fig 6-2 227 | 228 | 229 | ### Fig 6-3 230 | 231 | 232 | ### Fig 6-4 233 | 234 | 235 | ### Fig 6-5 236 | 237 | 238 | ### Fig 6-6 239 | 240 | 241 | ### Fig 6-7 242 | 243 | 244 | ### Fig 6-8 245 | 246 | 247 | ### Fig 6-9 248 | 249 | 250 | ### Fig 6-10 251 | 252 | 253 | ### Fig 6-11 254 | 255 | 256 | ### Fig 6-12 257 | 258 | 259 | ### Fig 6-13 260 | 261 | 262 | ### Fig 6-14 263 | 264 | 265 | ### Fig 6-15 266 | 267 | 268 | ### Fig 6-16 269 | 270 | 271 | ### Fig 6-17 272 | 273 | 274 | ^ contents 275 | 276 | 277 | 278 | ## Chapter 7 279 | ### Fig 7-1 280 | 281 | 282 | ^ contents 283 | 284 | 285 | 286 | ## Chapter 8 287 | ### Fig 8-1 288 | 289 | 290 | ### Fig 8-2 291 | 292 | 293 | ^ contents 294 | 295 | 296 | 297 | ## Chapter 9 298 | ### Fig 9-1 299 | 300 | 301 | ^ contents 302 | 303 | 304 | 305 | ## Chapter 10 306 | ### Fig 10-1 307 | 308 | 309 | ### Fig 10-2 310 | 311 | 312 | ### Fig 10-3 313 | 314 | 315 | ### Fig 10-4 316 | 317 | 318 | ### Fig 10-5 319 | 320 | 321 | ^ contents 322 | 323 | 324 | 325 | ## Chapter 11 326 | ### Fig 11-1 327 | 328 | 329 | ### Fig 11-2 330 | 331 | 332 | ^ contents 333 | 334 | 335 | 336 | ## Chapter 12 337 | ### Fig 12-1 338 | 339 | 340 | ### Fig 12-2 341 | 342 | 343 | ### Fig 12-3 344 | [🔍 view text version](/assets/ADR-example-decision-making.md) 345 | 346 | 347 | 348 | ### Fig 12-4 349 | [🔍 view text version](/assets/ADR-example-decision-making.md) 350 | 351 | 352 | 353 | ### Fig 12-5 354 | [🔍 view text version](/assets/ADR-example.md) 355 | 356 | 357 | 358 | ### Fig 12-6 359 | 360 | 361 | ### Fig 12-7 362 | 363 | 364 | ^ contents 365 | 366 | 367 | 368 | ## Chapter 13 369 | ### Fig 13-1 370 | 371 | 372 | ### Fig 13-2 373 | 374 | 375 | ^ contents 376 | 377 | 378 | 379 | ## Chapter 14 380 | ### Fig 14-1 381 | 382 | 383 | ^ contents 384 | 385 | 386 | 387 | ## Chapter 15 388 | ### Fig 15-1 389 | 390 | 391 | ### Fig 15-2 392 | 393 | 394 | ### Fig 15-3 395 | 396 | 397 | ### Fig 15-4 398 | 399 | 400 | ^ contents 401 | 402 | [> Home](README.md) -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | 26 | 29 | 30 | 31 | 274 | 275 | 276 | 280 | 281 |
4 |

Read the Book

5 |

Communication Patterns is available from many places, including:

6 | 23 |

Figures & Bonus Material

24 |

View figures from the book and access bonus resources.

25 |
27 | Book cover: Communication Patterns 28 |
32 |

Get in touch

33 | 51 |

Praise for Communication Patterns

52 | 53 |
54 | 260 |
261 |
262 |

From the Back Cover

263 |

Having a great idea or design is not enough to achieve success. You must communicate your vision effectively to gain stakeholder support for your design and secure collaboration and contribution from your teams. In this practical book, author Jacqui Read shows you how to successfully present your architecture and gain the commitment and understanding you need from stakeholders.

264 |

Discover how to effectively communicate to avoid misunderstandings that can lead to increasing costs, unmet requirements, and an architecture that is not what you intended. Through constructive examples and patterns, this book shows you how to express your message clearly to the different audiences you'll face.

265 |

This book shows you how to:

266 |
    267 |
  • Design diagrams and documentation suitable for your expected audience, intended message, and project stage
  • 268 |
  • Create artifacts that are accessible to those with varying roles, needs, or disabilities
  • 269 |
  • Master written, verbal, and nonverbal communication to succeed in technical settings
  • 270 |
  • Communicate and collaborate with distributed teams to successfully design and document software and technical projects
  • 271 |
  • Apply the communication patterns presented in this book in real-world projects and software designs
  • 272 |
273 |
277 |

Find Out More

278 |

To get the latest information please visit JacquiRead.com

279 |
282 |

^ marks an affiliate link from which I may earn commission at no cost to you.

-------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | https://creativecommons.org/licenses/by-sa/4.0/ 2 | 3 | Attribution-ShareAlike 4.0 International 4 | 5 | ======================================================================= 6 | 7 | Creative Commons Corporation ("Creative Commons") is not a law firm and 8 | does not provide legal services or legal advice. Distribution of 9 | Creative Commons public licenses does not create a lawyer-client or 10 | other relationship. Creative Commons makes its licenses and related 11 | information available on an "as-is" basis. Creative Commons gives no 12 | warranties regarding its licenses, any material licensed under their 13 | terms and conditions, or any related information. Creative Commons 14 | disclaims all liability for damages resulting from their use to the 15 | fullest extent possible. 16 | 17 | Using Creative Commons Public Licenses 18 | 19 | Creative Commons public licenses provide a standard set of terms and 20 | conditions that creators and other rights holders may use to share 21 | original works of authorship and other material subject to copyright 22 | and certain other rights specified in the public license below. The 23 | following considerations are for informational purposes only, are not 24 | exhaustive, and do not form part of our licenses. 25 | 26 | Considerations for licensors: Our public licenses are 27 | intended for use by those authorized to give the public 28 | permission to use material in ways otherwise restricted by 29 | copyright and certain other rights. Our licenses are 30 | irrevocable. Licensors should read and understand the terms 31 | and conditions of the license they choose before applying it. 32 | Licensors should also secure all rights necessary before 33 | applying our licenses so that the public can reuse the 34 | material as expected. Licensors should clearly mark any 35 | material not subject to the license. This includes other CC- 36 | licensed material, or material used under an exception or 37 | limitation to copyright. More considerations for licensors: 38 | wiki.creativecommons.org/Considerations_for_licensors 39 | 40 | Considerations for the public: By using one of our public 41 | licenses, a licensor grants the public permission to use the 42 | licensed material under specified terms and conditions. If 43 | the licensor's permission is not necessary for any reason--for 44 | example, because of any applicable exception or limitation to 45 | copyright--then that use is not regulated by the license. Our 46 | licenses grant only permissions under copyright and certain 47 | other rights that a licensor has authority to grant. Use of 48 | the licensed material may still be restricted for other 49 | reasons, including because others have copyright or other 50 | rights in the material. A licensor may make special requests, 51 | such as asking that all changes be marked or described. 52 | Although not required by our licenses, you are encouraged to 53 | respect those requests where reasonable. More considerations 54 | for the public: 55 | wiki.creativecommons.org/Considerations_for_licensees 56 | 57 | ======================================================================= 58 | 59 | Creative Commons Attribution-ShareAlike 4.0 International Public 60 | License 61 | 62 | By exercising the Licensed Rights (defined below), You accept and agree 63 | to be bound by the terms and conditions of this Creative Commons 64 | Attribution-ShareAlike 4.0 International Public License ("Public 65 | License"). To the extent this Public License may be interpreted as a 66 | contract, You are granted the Licensed Rights in consideration of Your 67 | acceptance of these terms and conditions, and the Licensor grants You 68 | such rights in consideration of benefits the Licensor receives from 69 | making the Licensed Material available under these terms and 70 | conditions. 71 | 72 | 73 | Section 1 -- Definitions. 74 | 75 | a. Adapted Material means material subject to Copyright and Similar 76 | Rights that is derived from or based upon the Licensed Material 77 | and in which the Licensed Material is translated, altered, 78 | arranged, transformed, or otherwise modified in a manner requiring 79 | permission under the Copyright and Similar Rights held by the 80 | Licensor. For purposes of this Public License, where the Licensed 81 | Material is a musical work, performance, or sound recording, 82 | Adapted Material is always produced where the Licensed Material is 83 | synched in timed relation with a moving image. 84 | 85 | b. Adapter's License means the license You apply to Your Copyright 86 | and Similar Rights in Your contributions to Adapted Material in 87 | accordance with the terms and conditions of this Public License. 88 | 89 | c. BY-SA Compatible License means a license listed at 90 | creativecommons.org/compatiblelicenses, approved by Creative 91 | Commons as essentially the equivalent of this Public License. 92 | 93 | d. Copyright and Similar Rights means copyright and/or similar rights 94 | closely related to copyright including, without limitation, 95 | performance, broadcast, sound recording, and Sui Generis Database 96 | Rights, without regard to how the rights are labeled or 97 | categorized. For purposes of this Public License, the rights 98 | specified in Section 2(b)(1)-(2) are not Copyright and Similar 99 | Rights. 100 | 101 | e. Effective Technological Measures means those measures that, in the 102 | absence of proper authority, may not be circumvented under laws 103 | fulfilling obligations under Article 11 of the WIPO Copyright 104 | Treaty adopted on December 20, 1996, and/or similar international 105 | agreements. 106 | 107 | f. Exceptions and Limitations means fair use, fair dealing, and/or 108 | any other exception or limitation to Copyright and Similar Rights 109 | that applies to Your use of the Licensed Material. 110 | 111 | g. License Elements means the license attributes listed in the name 112 | of a Creative Commons Public License. The License Elements of this 113 | Public License are Attribution and ShareAlike. 114 | 115 | h. Licensed Material means the artistic or literary work, database, 116 | or other material to which the Licensor applied this Public 117 | License. 118 | 119 | i. Licensed Rights means the rights granted to You subject to the 120 | terms and conditions of this Public License, which are limited to 121 | all Copyright and Similar Rights that apply to Your use of the 122 | Licensed Material and that the Licensor has authority to license. 123 | 124 | j. Licensor means the individual(s) or entity(ies) granting rights 125 | under this Public License. 126 | 127 | k. Share means to provide material to the public by any means or 128 | process that requires permission under the Licensed Rights, such 129 | as reproduction, public display, public performance, distribution, 130 | dissemination, communication, or importation, and to make material 131 | available to the public including in ways that members of the 132 | public may access the material from a place and at a time 133 | individually chosen by them. 134 | 135 | l. Sui Generis Database Rights means rights other than copyright 136 | resulting from Directive 96/9/EC of the European Parliament and of 137 | the Council of 11 March 1996 on the legal protection of databases, 138 | as amended and/or succeeded, as well as other essentially 139 | equivalent rights anywhere in the world. 140 | 141 | m. You means the individual or entity exercising the Licensed Rights 142 | under this Public License. Your has a corresponding meaning. 143 | 144 | 145 | Section 2 -- Scope. 146 | 147 | a. License grant. 148 | 149 | 1. Subject to the terms and conditions of this Public License, 150 | the Licensor hereby grants You a worldwide, royalty-free, 151 | non-sublicensable, non-exclusive, irrevocable license to 152 | exercise the Licensed Rights in the Licensed Material to: 153 | 154 | a. reproduce and Share the Licensed Material, in whole or 155 | in part; and 156 | 157 | b. produce, reproduce, and Share Adapted Material. 158 | 159 | 2. Exceptions and Limitations. For the avoidance of doubt, where 160 | Exceptions and Limitations apply to Your use, this Public 161 | License does not apply, and You do not need to comply with 162 | its terms and conditions. 163 | 164 | 3. Term. The term of this Public License is specified in Section 165 | 6(a). 166 | 167 | 4. Media and formats; technical modifications allowed. The 168 | Licensor authorizes You to exercise the Licensed Rights in 169 | all media and formats whether now known or hereafter created, 170 | and to make technical modifications necessary to do so. The 171 | Licensor waives and/or agrees not to assert any right or 172 | authority to forbid You from making technical modifications 173 | necessary to exercise the Licensed Rights, including 174 | technical modifications necessary to circumvent Effective 175 | Technological Measures. For purposes of this Public License, 176 | simply making modifications authorized by this Section 2(a) 177 | (4) never produces Adapted Material. 178 | 179 | 5. Downstream recipients. 180 | 181 | a. Offer from the Licensor -- Licensed Material. Every 182 | recipient of the Licensed Material automatically 183 | receives an offer from the Licensor to exercise the 184 | Licensed Rights under the terms and conditions of this 185 | Public License. 186 | 187 | b. Additional offer from the Licensor -- Adapted Material. 188 | Every recipient of Adapted Material from You 189 | automatically receives an offer from the Licensor to 190 | exercise the Licensed Rights in the Adapted Material 191 | under the conditions of the Adapter's License You apply. 192 | 193 | c. No downstream restrictions. You may not offer or impose 194 | any additional or different terms or conditions on, or 195 | apply any Effective Technological Measures to, the 196 | Licensed Material if doing so restricts exercise of the 197 | Licensed Rights by any recipient of the Licensed 198 | Material. 199 | 200 | 6. No endorsement. Nothing in this Public License constitutes or 201 | may be construed as permission to assert or imply that You 202 | are, or that Your use of the Licensed Material is, connected 203 | with, or sponsored, endorsed, or granted official status by, 204 | the Licensor or others designated to receive attribution as 205 | provided in Section 3(a)(1)(A)(i). 206 | 207 | b. Other rights. 208 | 209 | 1. Moral rights, such as the right of integrity, are not 210 | licensed under this Public License, nor are publicity, 211 | privacy, and/or other similar personality rights; however, to 212 | the extent possible, the Licensor waives and/or agrees not to 213 | assert any such rights held by the Licensor to the limited 214 | extent necessary to allow You to exercise the Licensed 215 | Rights, but not otherwise. 216 | 217 | 2. Patent and trademark rights are not licensed under this 218 | Public License. 219 | 220 | 3. To the extent possible, the Licensor waives any right to 221 | collect royalties from You for the exercise of the Licensed 222 | Rights, whether directly or through a collecting society 223 | under any voluntary or waivable statutory or compulsory 224 | licensing scheme. In all other cases the Licensor expressly 225 | reserves any right to collect such royalties. 226 | 227 | 228 | Section 3 -- License Conditions. 229 | 230 | Your exercise of the Licensed Rights is expressly made subject to the 231 | following conditions. 232 | 233 | a. Attribution. 234 | 235 | 1. If You Share the Licensed Material (including in modified 236 | form), You must: 237 | 238 | a. retain the following if it is supplied by the Licensor 239 | with the Licensed Material: 240 | 241 | i. identification of the creator(s) of the Licensed 242 | Material and any others designated to receive 243 | attribution, in any reasonable manner requested by 244 | the Licensor (including by pseudonym if 245 | designated); 246 | 247 | ii. a copyright notice; 248 | 249 | iii. a notice that refers to this Public License; 250 | 251 | iv. a notice that refers to the disclaimer of 252 | warranties; 253 | 254 | v. a URI or hyperlink to the Licensed Material to the 255 | extent reasonably practicable; 256 | 257 | b. indicate if You modified the Licensed Material and 258 | retain an indication of any previous modifications; and 259 | 260 | c. indicate the Licensed Material is licensed under this 261 | Public License, and include the text of, or the URI or 262 | hyperlink to, this Public License. 263 | 264 | 2. You may satisfy the conditions in Section 3(a)(1) in any 265 | reasonable manner based on the medium, means, and context in 266 | which You Share the Licensed Material. For example, it may be 267 | reasonable to satisfy the conditions by providing a URI or 268 | hyperlink to a resource that includes the required 269 | information. 270 | 271 | 3. If requested by the Licensor, You must remove any of the 272 | information required by Section 3(a)(1)(A) to the extent 273 | reasonably practicable. 274 | 275 | b. ShareAlike. 276 | 277 | In addition to the conditions in Section 3(a), if You Share 278 | Adapted Material You produce, the following conditions also apply. 279 | 280 | 1. The Adapter's License You apply must be a Creative Commons 281 | license with the same License Elements, this version or 282 | later, or a BY-SA Compatible License. 283 | 284 | 2. You must include the text of, or the URI or hyperlink to, the 285 | Adapter's License You apply. You may satisfy this condition 286 | in any reasonable manner based on the medium, means, and 287 | context in which You Share Adapted Material. 288 | 289 | 3. You may not offer or impose any additional or different terms 290 | or conditions on, or apply any Effective Technological 291 | Measures to, Adapted Material that restrict exercise of the 292 | rights granted under the Adapter's License You apply. 293 | 294 | 295 | Section 4 -- Sui Generis Database Rights. 296 | 297 | Where the Licensed Rights include Sui Generis Database Rights that 298 | apply to Your use of the Licensed Material: 299 | 300 | a. for the avoidance of doubt, Section 2(a)(1) grants You the right 301 | to extract, reuse, reproduce, and Share all or a substantial 302 | portion of the contents of the database; 303 | 304 | b. if You include all or a substantial portion of the database 305 | contents in a database in which You have Sui Generis Database 306 | Rights, then the database in which You have Sui Generis Database 307 | Rights (but not its individual contents) is Adapted Material, 308 | including for purposes of Section 3(b); and 309 | 310 | c. You must comply with the conditions in Section 3(a) if You Share 311 | all or a substantial portion of the contents of the database. 312 | 313 | For the avoidance of doubt, this Section 4 supplements and does not 314 | replace Your obligations under this Public License where the Licensed 315 | Rights include other Copyright and Similar Rights. 316 | 317 | 318 | Section 5 -- Disclaimer of Warranties and Limitation of Liability. 319 | 320 | a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE 321 | EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS 322 | AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF 323 | ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS, 324 | IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION, 325 | WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR 326 | PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS, 327 | ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT 328 | KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT 329 | ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU. 330 | 331 | b. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE 332 | TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION, 333 | NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT, 334 | INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES, 335 | COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR 336 | USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN 337 | ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR 338 | DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR 339 | IN PART, THIS LIMITATION MAY NOT APPLY TO YOU. 340 | 341 | c. The disclaimer of warranties and limitation of liability provided 342 | above shall be interpreted in a manner that, to the extent 343 | possible, most closely approximates an absolute disclaimer and 344 | waiver of all liability. 345 | 346 | 347 | Section 6 -- Term and Termination. 348 | 349 | a. This Public License applies for the term of the Copyright and 350 | Similar Rights licensed here. However, if You fail to comply with 351 | this Public License, then Your rights under this Public License 352 | terminate automatically. 353 | 354 | b. Where Your right to use the Licensed Material has terminated under 355 | Section 6(a), it reinstates: 356 | 357 | 1. automatically as of the date the violation is cured, provided 358 | it is cured within 30 days of Your discovery of the 359 | violation; or 360 | 361 | 2. upon express reinstatement by the Licensor. 362 | 363 | For the avoidance of doubt, this Section 6(b) does not affect any 364 | right the Licensor may have to seek remedies for Your violations 365 | of this Public License. 366 | 367 | c. For the avoidance of doubt, the Licensor may also offer the 368 | Licensed Material under separate terms or conditions or stop 369 | distributing the Licensed Material at any time; however, doing so 370 | will not terminate this Public License. 371 | 372 | d. Sections 1, 5, 6, 7, and 8 survive termination of this Public 373 | License. 374 | 375 | 376 | Section 7 -- Other Terms and Conditions. 377 | 378 | a. The Licensor shall not be bound by any additional or different 379 | terms or conditions communicated by You unless expressly agreed. 380 | 381 | b. Any arrangements, understandings, or agreements regarding the 382 | Licensed Material not stated herein are separate from and 383 | independent of the terms and conditions of this Public License. 384 | 385 | 386 | Section 8 -- Interpretation. 387 | 388 | a. For the avoidance of doubt, this Public License does not, and 389 | shall not be interpreted to, reduce, limit, restrict, or impose 390 | conditions on any use of the Licensed Material that could lawfully 391 | be made without permission under this Public License. 392 | 393 | b. To the extent possible, if any provision of this Public License is 394 | deemed unenforceable, it shall be automatically reformed to the 395 | minimum extent necessary to make it enforceable. If the provision 396 | cannot be reformed, it shall be severed from this Public License 397 | without affecting the enforceability of the remaining terms and 398 | conditions. 399 | 400 | c. No term or condition of this Public License will be waived and no 401 | failure to comply consented to unless expressly agreed to by the 402 | Licensor. 403 | 404 | d. Nothing in this Public License constitutes or may be interpreted 405 | as a limitation upon, or waiver of, any privileges and immunities 406 | that apply to the Licensor or You, including from the legal 407 | processes of any jurisdiction or authority. 408 | 409 | 410 | ======================================================================= 411 | 412 | Creative Commons is not a party to its public licenses. 413 | Notwithstanding, Creative Commons may elect to apply one of its public 414 | licenses to material it publishes and in those instances will be 415 | considered the “Licensor.” The text of the Creative Commons public 416 | licenses is dedicated to the public domain under the CC0 Public Domain 417 | Dedication. Except for the limited purpose of indicating that material 418 | is shared under a Creative Commons public license or as otherwise 419 | permitted by the Creative Commons policies published at 420 | creativecommons.org/policies, Creative Commons does not authorize the 421 | use of the trademark "Creative Commons" or any other trademark or logo 422 | of Creative Commons without its prior written consent including, 423 | without limitation, in connection with any unauthorized modifications 424 | to any of its public licenses or any other arrangements, 425 | understandings, or agreements concerning use of licensed material. For 426 | the avoidance of doubt, this paragraph does not form part of the public 427 | licenses. 428 | 429 | Creative Commons may be contacted at creativecommons.org. 430 | --------------------------------------------------------------------------------