Update summaries for architecture

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:

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

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']
 ---

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']

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:

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']
 ---

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']
 ---

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']
 ---