From c9d3a338493d584b3a69c2b69f64228b31e437fb Mon Sep 17 00:00:00 2001 From: Lara Javalyn <132914464+larajavalyn@users.noreply.github.com> Date: Tue, 18 Nov 2025 14:17:02 -0500 Subject: [PATCH 01/20] Refine summary for consistency guidance Updated summary to provide more detailed guidance on consistency in distributed systems. --- architecture/consistency.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/architecture/consistency.md b/architecture/consistency.md index 9172de49acf..6b71af11ecf 100644 --- a/architecture/consistency.md +++ b/architecture/consistency.md @@ -1,6 +1,6 @@ --- title: Consistency -summary: Achieving consistency in distributed, message-driven systems +summary: Guidance for consistency in distributed message-driven systems through transactions, outbox, idempotency, deduplication, workflows, and practical trade-offs. reviewed: 2025-07-15 callsToAction: ['solution-architect'] redirects: From 71ac3c11003177450cd48068393d5da8059afc9c Mon Sep 17 00:00:00 2001 From: Lara Javalyn <132914464+larajavalyn@users.noreply.github.com> Date: Tue, 18 Nov 2025 14:24:52 -0500 Subject: [PATCH 02/20] Enhance summary of data distribution concepts Expanded summary to provide a more detailed overview of data distribution concepts and their differences from pub/sub. --- architecture/data-distribution.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/architecture/data-distribution.md b/architecture/data-distribution.md index 3a3e6006a77..69d2025843b 100644 --- a/architecture/data-distribution.md +++ b/architecture/data-distribution.md @@ -1,6 +1,6 @@ --- title: Data distribution -summary: Data distribution concepts and how it differs from pub/sub +summary: Overview of broadcasting data to multiple nodes, why asynchronous messaging is unreliable for synchronized state, how this differs from pub/sub eventing, and why distributed caches or config stores (e.g., Redis, Consul, etcd) are typically preferred. reviewed: 2024-04-16 redirects: - nservicebus/azure/data-distribution From 108bbeb08f3303c8e2a792a4c68a1c146bfe149a Mon Sep 17 00:00:00 2001 From: Lara Javalyn <132914464+larajavalyn@users.noreply.github.com> Date: Tue, 18 Nov 2025 14:27:12 -0500 Subject: [PATCH 03/20] Revise summary for hybrid systems documentation Updated the summary to provide more detailed architectural guidance on hybrid cloud and on-prem systems, including messaging approaches. --- architecture/hybrid-systems.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/architecture/hybrid-systems.md b/architecture/hybrid-systems.md index 57691b59d5a..07800ede4a1 100644 --- a/architecture/hybrid-systems.md +++ b/architecture/hybrid-systems.md @@ -1,6 +1,6 @@ --- title: Hybrid systems -summary: Systems deployed both in the cloud and on-premises +summary: Architectural guidance for hybrid cloud and on-prem systems. Shared vs multiple message-broker approaches, Messaging Bridge pattern, and NServiceBus Bridge sample. reviewed: 2025-06-26 callsToAction: ['solution-architect', 'poc-help'] --- From e7943f846a5e193ab35baa2daff92e7a1548c558 Mon Sep 17 00:00:00 2001 From: Lara Javalyn <132914464+larajavalyn@users.noreply.github.com> Date: Tue, 18 Nov 2025 14:31:24 -0500 Subject: [PATCH 04/20] Update architecture summary for clarity Expanded summary to include additional topics related to the Particular Service Platform. --- architecture/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/architecture/index.md b/architecture/index.md index f6b68d54fb8..bf9bedeb4b4 100644 --- a/architecture/index.md +++ b/architecture/index.md @@ -1,6 +1,6 @@ --- title: Architecture -summary: Architectural guidance for building distributed systems with the Particular Service Platform both in the cloud and on-premises. +summary: Architectural guidance for building distributed systems with the Particular Service Platform, including messaging, recoverability, consistency, workflows, and Azure/AWS. reviewed: 2025-06-29 suppressRelated: true callsToAction: ['architecture-review'] From 9a0520e24b14ddf639541b482f4f6d934194af60 Mon Sep 17 00:00:00 2001 From: Lara Javalyn <132914464+larajavalyn@users.noreply.github.com> Date: Tue, 18 Nov 2025 15:13:46 -0500 Subject: [PATCH 05/20] Enhance summary of messaging concepts Updated summary to provide a more detailed overview of messaging concepts in distributed systems. --- architecture/messaging.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/architecture/messaging.md b/architecture/messaging.md index d06c3c18796..f5e84e41358 100644 --- a/architecture/messaging.md +++ b/architecture/messaging.md @@ -1,6 +1,6 @@ --- title: Messaging -summary: Messaging concepts for building distributed systems +summary: Overview of messaging in distributed systems with concepts, benefits, key patterns (commands, events, request/reply, pub/sub), command-query separation, and transport options. reviewed: 2025-07-03 callsToAction: ['solution-architect'] redirects: From 65f11b571dbe379d43894dfabd9290a4ff19bf6e Mon Sep 17 00:00:00 2001 From: Lara Javalyn <132914464+larajavalyn@users.noreply.github.com> Date: Tue, 18 Nov 2025 15:18:36 -0500 Subject: [PATCH 06/20] Enhance observability summary with detailed techniques Expanded summary to include specific observability techniques and tools. --- architecture/observability.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/architecture/observability.md b/architecture/observability.md index bbb403b9472..a14b990d229 100644 --- a/architecture/observability.md +++ b/architecture/observability.md @@ -1,6 +1,6 @@ --- title: Observability -summary: Observability techniques for building observable distributed systems +summary: Observability for distributed systems including techniques for root-cause analysis, health and performance monitoring, OpenTelemetry guidance, and Particular Service Platform tooling. reviewed: 2024-03-20 callsToAction: ['solution-architect'] --- From 1d5ae9275339f85a1ba5fb1749b8b6a51fe10b59 Mon Sep 17 00:00:00 2001 From: Lara Javalyn <132914464+larajavalyn@users.noreply.github.com> Date: Tue, 18 Nov 2025 15:20:33 -0500 Subject: [PATCH 07/20] Revise summary for recoverability techniques Updated summary to specify techniques for message recoverability and handling failures. --- architecture/recoverability.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/architecture/recoverability.md b/architecture/recoverability.md index d8bf1fd58ff..c644003b647 100644 --- a/architecture/recoverability.md +++ b/architecture/recoverability.md @@ -1,6 +1,6 @@ --- title: Recoverability -summary: Recoverability techniques for building resilient distributed systems +summary: Techniques for message recoverability. Handle transient and persistent failures with immediate/delayed retries, error queues, and Particular Platform tools. reviewed: 2025-07-03 callsToAction: ['solution-architect'] --- From 281785df7164b9a45d6db475ad7ce7155d080834 Mon Sep 17 00:00:00 2001 From: Lara Javalyn <132914464+larajavalyn@users.noreply.github.com> Date: Tue, 18 Nov 2025 15:25:16 -0500 Subject: [PATCH 08/20] Enhance summary in workflows documentation Updated summary to include implementation details of choreographed and orchestrated workflows using NServiceBus sagas. --- architecture/workflows.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/architecture/workflows.md b/architecture/workflows.md index 2e742c6323a..23ecbb2b2f0 100644 --- a/architecture/workflows.md +++ b/architecture/workflows.md @@ -1,6 +1,6 @@ --- title: Workflows -summary: Techniques for building stateful business workflows in distributed systems +summary: Techniques for building stateful business workflows in distributed systems. Implementation of choreographed and orchestrated workflows using NServiceBus sagas. reviewed: 2025-06-30 callsToAction: ['solution-architect'] --- From d1e8087285e5feb1f600b9f7c1d59b2691aaabdc Mon Sep 17 00:00:00 2001 From: Lara Javalyn <132914464+larajavalyn@users.noreply.github.com> Date: Tue, 18 Nov 2025 15:29:49 -0500 Subject: [PATCH 09/20] Update summary for workflows documentation --- architecture/workflows.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/architecture/workflows.md b/architecture/workflows.md index 23ecbb2b2f0..ee462e4cbd6 100644 --- a/architecture/workflows.md +++ b/architecture/workflows.md @@ -1,6 +1,6 @@ --- title: Workflows -summary: Techniques for building stateful business workflows in distributed systems. Implementation of choreographed and orchestrated workflows using NServiceBus sagas. +summary: Techniques for building stateful business workflows in distributed systems and implementation of choreographed and orchestrated workflows using NServiceBus sagas. reviewed: 2025-06-30 callsToAction: ['solution-architect'] --- From 8cbbc916a21e944f859a69e540402d4480c032d1 Mon Sep 17 00:00:00 2001 From: Lara Javalyn <132914464+larajavalyn@users.noreply.github.com> Date: Tue, 18 Nov 2025 15:33:00 -0500 Subject: [PATCH 10/20] Update summary for consistency in message-driven systems --- architecture/consistency.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/architecture/consistency.md b/architecture/consistency.md index 6b71af11ecf..0438a37d97d 100644 --- a/architecture/consistency.md +++ b/architecture/consistency.md @@ -1,6 +1,6 @@ --- title: Consistency -summary: Guidance for consistency in distributed message-driven systems through transactions, outbox, idempotency, deduplication, workflows, and practical trade-offs. +summary: Consistency in message-driven systems using transactions, outbox patterns, idempotency, deduplication, workflows, and key trade-offs. reviewed: 2025-07-15 callsToAction: ['solution-architect'] redirects: From 1c0d3a864c36092f46dd01496531f86a91e44b39 Mon Sep 17 00:00:00 2001 From: Lara Javalyn <132914464+larajavalyn@users.noreply.github.com> Date: Tue, 18 Nov 2025 15:34:44 -0500 Subject: [PATCH 11/20] Revise summary for data distribution document --- architecture/data-distribution.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/architecture/data-distribution.md b/architecture/data-distribution.md index 69d2025843b..050a0ddef20 100644 --- a/architecture/data-distribution.md +++ b/architecture/data-distribution.md @@ -1,6 +1,6 @@ --- title: Data distribution -summary: Overview of broadcasting data to multiple nodes, why asynchronous messaging is unreliable for synchronized state, how this differs from pub/sub eventing, and why distributed caches or config stores (e.g., Redis, Consul, etcd) are typically preferred. +summary: Broadcasting to many nodes is unreliable for synced state; unlike pub/sub, use distributed caches or config stores for consistent, dependable updates. reviewed: 2024-04-16 redirects: - nservicebus/azure/data-distribution From b404f65bd2f6217866b1d467e86b04be2fc9ffb5 Mon Sep 17 00:00:00 2001 From: Lara Javalyn <132914464+larajavalyn@users.noreply.github.com> Date: Tue, 18 Nov 2025 15:35:42 -0500 Subject: [PATCH 12/20] Refine summary for hybrid systems guidance --- architecture/hybrid-systems.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/architecture/hybrid-systems.md b/architecture/hybrid-systems.md index 07800ede4a1..70b9ac1c5d5 100644 --- a/architecture/hybrid-systems.md +++ b/architecture/hybrid-systems.md @@ -1,6 +1,6 @@ --- title: Hybrid systems -summary: Architectural guidance for hybrid cloud and on-prem systems. Shared vs multiple message-broker approaches, Messaging Bridge pattern, and NServiceBus Bridge sample. +summary: Guidance for hybrid cloud/on-prem: when to use shared vs separate brokers, and how a Messaging Bridge (e.g., NServiceBus Bridge) links the two. reviewed: 2025-06-26 callsToAction: ['solution-architect', 'poc-help'] --- From d99a70783549f37a4cecff4805f22cc482815490 Mon Sep 17 00:00:00 2001 From: Lara Javalyn <132914464+larajavalyn@users.noreply.github.com> Date: Tue, 18 Nov 2025 15:36:49 -0500 Subject: [PATCH 13/20] Update summary for messaging documentation --- architecture/messaging.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/architecture/messaging.md b/architecture/messaging.md index f5e84e41358..e93b36be7ba 100644 --- a/architecture/messaging.md +++ b/architecture/messaging.md @@ -1,6 +1,6 @@ --- title: Messaging -summary: Overview of messaging in distributed systems with concepts, benefits, key patterns (commands, events, request/reply, pub/sub), command-query separation, and transport options. +summary: Distributed messaging basics including benefits, key patterns (commands, events, request/reply, pub/sub), command–query separation, and transport options. reviewed: 2025-07-03 callsToAction: ['solution-architect'] redirects: From ac3086c73b28bdf00147fa7a2f7ff67993500b7a Mon Sep 17 00:00:00 2001 From: Lara Javalyn <132914464+larajavalyn@users.noreply.github.com> Date: Tue, 18 Nov 2025 15:38:01 -0500 Subject: [PATCH 14/20] Update summary for observability documentation --- architecture/observability.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/architecture/observability.md b/architecture/observability.md index a14b990d229..495971cf0d0 100644 --- a/architecture/observability.md +++ b/architecture/observability.md @@ -1,6 +1,6 @@ --- title: Observability -summary: Observability for distributed systems including techniques for root-cause analysis, health and performance monitoring, OpenTelemetry guidance, and Particular Service Platform tooling. +summary: Observability in distributed systems including root-cause analysis, health/performance monitoring, OpenTelemetry guidance, and Particular Platform tools. reviewed: 2024-03-20 callsToAction: ['solution-architect'] --- From e97c1dbb3f649103db8701e7e4912c455e67623c Mon Sep 17 00:00:00 2001 From: Lara Javalyn <132914464+larajavalyn@users.noreply.github.com> Date: Tue, 18 Nov 2025 15:39:55 -0500 Subject: [PATCH 15/20] Fix summary formatting in hybrid-systems.md --- architecture/hybrid-systems.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/architecture/hybrid-systems.md b/architecture/hybrid-systems.md index 70b9ac1c5d5..a5750d276c8 100644 --- a/architecture/hybrid-systems.md +++ b/architecture/hybrid-systems.md @@ -1,6 +1,6 @@ --- title: Hybrid systems -summary: Guidance for hybrid cloud/on-prem: when to use shared vs separate brokers, and how a Messaging Bridge (e.g., NServiceBus Bridge) links the two. +summary: Guidance for hybrid cloud/on-prem, when to use shared vs separate brokers, and how a Messaging Bridge (e.g., NServiceBus Bridge) links the two. reviewed: 2025-06-26 callsToAction: ['solution-architect', 'poc-help'] --- From 034d4a066545e58140350c636654a499baa987b7 Mon Sep 17 00:00:00 2001 From: Jayanthi Date: Tue, 18 Nov 2025 14:40:04 -0800 Subject: [PATCH 16/20] Revise summary for workflows documentation --- architecture/workflows.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/architecture/workflows.md b/architecture/workflows.md index ee462e4cbd6..18c306acddd 100644 --- a/architecture/workflows.md +++ b/architecture/workflows.md @@ -1,6 +1,6 @@ --- title: Workflows -summary: Techniques for building stateful business workflows in distributed systems and implementation of choreographed and orchestrated workflows using NServiceBus sagas. +summary: Stateful workflow techniques in distributed systems using NServiceBus sagas for choreographed and orchestrated business processes reviewed: 2025-06-30 callsToAction: ['solution-architect'] --- From 1cb9d00c67a350fb84e3eccb1d03fc71e1550bb9 Mon Sep 17 00:00:00 2001 From: Jayanthi Date: Tue, 18 Nov 2025 14:44:46 -0800 Subject: [PATCH 17/20] Fix summary formatting in architecture index Removed the comma before 'Azure' in the summary. --- architecture/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/architecture/index.md b/architecture/index.md index bf9bedeb4b4..0c5ec19a0dc 100644 --- a/architecture/index.md +++ b/architecture/index.md @@ -1,6 +1,6 @@ --- title: Architecture -summary: Architectural guidance for building distributed systems with the Particular Service Platform, including messaging, recoverability, consistency, workflows, and Azure/AWS. +summary: Architectural guidance for building distributed systems with the Particular Service Platform, including messaging, recoverability, consistency, workflows, Azure, AWS. reviewed: 2025-06-29 suppressRelated: true callsToAction: ['architecture-review'] From 82cbc794b9cb7fe41137f4453e225ac238003045 Mon Sep 17 00:00:00 2001 From: Jayanthi Date: Tue, 18 Nov 2025 14:47:19 -0800 Subject: [PATCH 18/20] Update summary for architecture documentation --- architecture/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/architecture/index.md b/architecture/index.md index 0c5ec19a0dc..3ef14559a7d 100644 --- a/architecture/index.md +++ b/architecture/index.md @@ -1,6 +1,6 @@ --- title: Architecture -summary: Architectural guidance for building distributed systems with the Particular Service Platform, including messaging, recoverability, consistency, workflows, Azure, AWS. +summary: Architectural guidance for building distributed systems using Particular Service Platform with messaging, recoverability, consistency, workflows, Azure, AWS reviewed: 2025-06-29 suppressRelated: true callsToAction: ['architecture-review'] From 0cded25172f3b64441fd668453552e7b24b7f528 Mon Sep 17 00:00:00 2001 From: Lara Javalyn <132914464+larajavalyn@users.noreply.github.com> Date: Fri, 21 Nov 2025 09:18:30 -0500 Subject: [PATCH 19/20] Update architecture/consistency.md Co-authored-by: Jayanthi --- architecture/consistency.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/architecture/consistency.md b/architecture/consistency.md index 0438a37d97d..5409fe3ea6d 100644 --- a/architecture/consistency.md +++ b/architecture/consistency.md @@ -1,6 +1,6 @@ --- title: Consistency -summary: Consistency in message-driven systems using transactions, outbox patterns, idempotency, deduplication, workflows, and key trade-offs. +summary: Ensuring consistency in message-driven systems using transactions, outbox patterns, idempotency, deduplication, workflows, and key trade-offs. reviewed: 2025-07-15 callsToAction: ['solution-architect'] redirects: From 817805b6b88076d3a7ea6c0b48d2a130effb74e1 Mon Sep 17 00:00:00 2001 From: Lara Javalyn <132914464+larajavalyn@users.noreply.github.com> Date: Fri, 21 Nov 2025 09:18:40 -0500 Subject: [PATCH 20/20] Update architecture/data-distribution.md Co-authored-by: Jayanthi --- architecture/data-distribution.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/architecture/data-distribution.md b/architecture/data-distribution.md index 050a0ddef20..fa241314384 100644 --- a/architecture/data-distribution.md +++ b/architecture/data-distribution.md @@ -1,6 +1,7 @@ --- title: Data distribution -summary: Broadcasting to many nodes is unreliable for synced state; unlike pub/sub, use distributed caches or config stores for consistent, dependable updates. +summary: Broadcasting to many nodes is unreliable for synced state; prefer distributed caches or config stores over pub/sub for consistency + reviewed: 2024-04-16 redirects: - nservicebus/azure/data-distribution