diff --git a/architecture/consistency.md b/architecture/consistency.md index 9172de49acf..5409fe3ea6d 100644 --- a/architecture/consistency.md +++ b/architecture/consistency.md @@ -1,6 +1,6 @@ --- title: Consistency -summary: Achieving consistency in distributed, message-driven systems +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: diff --git a/architecture/data-distribution.md b/architecture/data-distribution.md index 3a3e6006a77..fa241314384 100644 --- a/architecture/data-distribution.md +++ b/architecture/data-distribution.md @@ -1,6 +1,7 @@ --- title: Data distribution -summary: Data distribution concepts and how it differs from pub/sub +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 diff --git a/architecture/hybrid-systems.md b/architecture/hybrid-systems.md index 57691b59d5a..a5750d276c8 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: 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'] --- diff --git a/architecture/index.md b/architecture/index.md index f6b68d54fb8..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 both in the cloud and on-premises. +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'] diff --git a/architecture/messaging.md b/architecture/messaging.md index d06c3c18796..e93b36be7ba 100644 --- a/architecture/messaging.md +++ b/architecture/messaging.md @@ -1,6 +1,6 @@ --- title: Messaging -summary: Messaging concepts for building distributed systems +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: diff --git a/architecture/observability.md b/architecture/observability.md index bbb403b9472..495971cf0d0 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 in distributed systems including root-cause analysis, health/performance monitoring, OpenTelemetry guidance, and Particular Platform tools. reviewed: 2024-03-20 callsToAction: ['solution-architect'] --- 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'] --- diff --git a/architecture/workflows.md b/architecture/workflows.md index 2e742c6323a..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 +summary: Stateful workflow techniques in distributed systems using NServiceBus sagas for choreographed and orchestrated business processes reviewed: 2025-06-30 callsToAction: ['solution-architect'] ---