menu.yaml

- Name: Getting Started
  Topics:
  - Title: Quick Start Tutorial
    Articles:
    - Url: tutorials/quickstart
      Title: "Part 1: Introduction"
    - Url: tutorials/quickstart/tutorial-reliability
      Title: "Part 2: Recovering from failure"
    - Url: tutorials/quickstart/tutorial-extending-the-system
      Title: "Part 3: Extending the system"
  - Title: NServiceBus Step-by-step
    Articles:
    - Url: tutorials/nservicebus-step-by-step
      Title: Introduction
    - Url: tutorials/nservicebus-step-by-step/1-getting-started
      Title: "Part 1: Getting Started"
    - Url: tutorials/nservicebus-step-by-step/2-sending-a-command
      Title: "Part 2: Sending a command"
    - Url: tutorials/nservicebus-step-by-step/3-multiple-endpoints
      Title: "Part 3: Multiple endpoints"
    - Url: tutorials/nservicebus-step-by-step/4-publishing-events
      Title: "Part 4: Publishing events"
    - Url: tutorials/nservicebus-step-by-step/5-retrying-errors
      Title: "Part 5: Retrying errors"
  - Title: NServiceBus Sagas
    Articles:
    - Url: tutorials/nservicebus-sagas
      Title: Introduction
    - Url: tutorials/nservicebus-sagas/1-saga-basics
      Title: "Part 1: Saga basics"
    - Url: tutorials/nservicebus-sagas/2-timeouts
      Title: "Part 2: Timeouts"
    - Url: tutorials/nservicebus-sagas/3-integration
      Title: "Part 3: Third-party integration"
  - Title: NServiceBus monitoring demo
    Articles:
    - Url: tutorials/monitoring-demo
      Title: Introduction
    - Url: tutorials/monitoring-demo/walkthrough-1
      Title: "Monitoring NServiceBus Demo - Slow handlers"
    - Url: tutorials/monitoring-demo/walkthrough-2
      Title: "Monitoring NServiceBus Demo - Message backlogs"
    - Url: tutorials/monitoring-demo/walkthrough-3
      Title: "Monitoring NServiceBus Demo - Struggling endpoints"
  - Url: get-started
    Title: Overview
  - Url: get-started/high-level-content
    Title: High-level content

- Name: Architecture
  Topics:
  - Title: Introduction
    Url: architecture
  - Title: Concepts
    Articles:
    - Title: Messaging
      Url: architecture/messaging
    - Title: Recoverability
      Url: architecture/recoverability
    - Title: Consistency
      Url: architecture/consistency
    - Title: Workflows
      Url: architecture/workflows
    - Title: Hybrid systems
      Url: architecture/hybrid-systems
    - Title: Polycloud systems
      Url: architecture/polycloud
    - Title: Observability
      Url: architecture/observability
    - Title: Data distribution
      Url: architecture/data-distribution
  - Title: Azure
    Articles:
    - Title: Introduction
      Url: architecture/azure
    - Title: Architectural styles
      Articles:
      - Title: Event-driven
        Url: architecture/azure/event-driven-architecture
      - Title: Microservices
        Url: architecture/azure/microservices
      - Title: N-tier
        Url: architecture/azure/n-tier
      - Title: Web-queue-worker
        Url: architecture/azure/web-queue-worker
    - Title: Technology choices
      Articles:
      - Title: Compute
        Url: architecture/azure/compute
      - Title: Data stores
        Url: architecture/azure/data-stores
      - Title: Messaging
        Url: architecture/azure/messaging
      - Title: Observability
        Url: architecture/azure/observability
    - Title: Security
      Articles:
      - Title: Attribute-Based Access Control (ABAC)
        Url: architecture/azure/azure-abac-auth
  - Title: AWS
    Articles:
    - Title: Introduction
      Url: architecture/aws
    - Title: Well-Architected Framework
      Url: architecture/aws/well-architected
    - Title: Architectural styles
      Articles:
      - Title: Event-driven
        Url: architecture/aws/event-driven-architecture
      - Title: Microservices
        Url: architecture/aws/microservices
      - Title: Multi-tier
        Url: architecture/aws/multi-tier-architecture
      - Title: Queue-based
        Url: architecture/aws/queue-based-architecture
    - Title: Technology choices
      Articles:
      - Title: Compute
        Url: architecture/aws/compute
      - Title: Data stores
        Url: architecture/aws/data-stores
      - Title: Messaging
        Url: architecture/aws/messaging
      - Title: Observability
        Url: architecture/aws/observability

- Name: Service Platform
  Topics:
  - Title: Introduction
    Url: platform
  - Title: Installation
    Url: platform/installation
  - Title: Platform Sample installation
    Url: platform/platform-sample-package
  - Title: MassTransit Error Management
    Url: platform/masstransit
  - Title: Connecting NServiceBus
    Articles:
    - Title: Using the NuGet package
      Url: platform/connecting
    - Title: Configuration schema
      Url: platform/json-schema
  - Title: Contributing
    Url: platform/contributing
  - Title: Release notifications
    Url: nservicebus/release-notifications
  - Title: Third-party licenses
    Url: platform/third-party-licenses
  - Title: Usage Report Requirements
    Url: platform/throughput-report

- Name: NServiceBus
  Topics:
  - Title: General
    Articles:
    - Url: nservicebus
      Title: About NServiceBus
    - Url: nservicebus/best-practices
      Title: Best practices
    - Url: nservicebus/concepts
      Title: Messaging Concepts
      Articles:
      - Url: nservicebus/concepts/glossary
        Title: Glossary
      - Url: nservicebus/concepts/priority-queues
        Title: Priority Queues
    - Url: nservicebus/dotnet-templates
      Title: dotnet new Templates
    - Url: nservicebus/platform-nuget-packages
      Title: Platform NuGet packages
    - Url: nservicebus/vscode
      Title: Debugging in VS Code
    - Url: nservicebus/licensing
      Title: License
    - Url: nservicebus/community
      Title: Community extensions and integrations
    - Url: nservicebus/scaling
      Title: Scaling out
    - Url: nservicebus/biztalk
      Title: NServiceBus and Biztalk
    - Url: nservicebus/azure
      Title: NServiceBus and Azure

  - Title: Support Policy
    Articles:
    - Url: nservicebus/upgrades/support-policy
      Title: About
    - Url: nservicebus/upgrades/supported-versions
      Title: Supported versions
    - Url: nservicebus/upgrades/all-versions
      Title: All versions
    - Url: nservicebus/upgrades/supported-platforms
      Title: Supported frameworks and platforms
    - Url: nservicebus/upgrades/release-policy
      Title: Release Policy

  - Title: Upgrade Guides
    Articles:
    - Url: nservicebus/upgrades
      Title: About upgrading NServiceBus
    - Url: nservicebus/upgrades/10to11
      Title: NServiceBus 10 to 11
    - Url: nservicebus/upgrades/9to10
      Title: NServiceBus 9 to 10
    - Url: nservicebus/upgrades/9to9.1
      Title: NServiceBus 9 to 9.1
    - Url: nservicebus/upgrades/8to9
      Title: NServiceBus 8 to 9
    - Url: nservicebus/upgrades/7to8
      Title: NServiceBus 7 to 8
      Articles:
      - Url: nservicebus/upgrades/7to8/transport
        Title: Transport Configuration Changes
      - Url: nservicebus/upgrades/7to8/dependency-injection
        Title: Dependency Injection Changes
      - Url: nservicebus/upgrades/7to8/message-contracts
        Title: Upgrading shared message contracts
      - Url: nservicebus/upgrades/7to8/databus
        Title: Upgrading databus changes
    - Url: nservicebus/upgrades/6to7
      Title: NServiceBus 6 to 7
      Articles:
      - Url: nservicebus/upgrades/encryption-1to2
        Title: Encryption
      - Url: nservicebus/upgrades/6to7/moving-msmq-subscriptions
        Title: Migrating Msmq subscriptions
    - Url: nservicebus/upgrades/6to6.2
      Title: NServiceBus 6 to 6.2
    - Url: nservicebus/upgrades/5to6
      Title: NServiceBus 5 to 6
      Articles:
      - Url: nservicebus/upgrades/5to6/moving-away-from-ibus
        Title: Migrating off IBus
      - Url: nservicebus/upgrades/5to6/endpoint
        Title: Endpoint API changes
      - Url: nservicebus/upgrades/5to6/handlers-and-sagas
        Title: Handlers and Sagas
      - Url: nservicebus/upgrades/5to6/async-suffix
        Title: Async Suffix
      - Url: nservicebus/upgrades/5to6/transaction-configuration
        Title: Transaction configuration
      - Url: nservicebus/upgrades/5to6/headers
        Title: Headers
      - Url: nservicebus/upgrades/5to6/callbacks
        Title: Callbacks
      - Url: nservicebus/upgrades/5to6/messaging
        Title: Messaging
      - Url: nservicebus/upgrades/5to6/serialization
        Title: Serialization
      - Url: nservicebus/upgrades/5to6/recoverability
        Title: Recoverability
      - Url: nservicebus/upgrades/5to6/subscriptions
        Title: Subscriptions
      - Url: nservicebus/upgrades/5to6/assembly-scanning
        Title: Assembly Scanning
      - Url: nservicebus/upgrades/5to6/deprecated-transportmessage
        Title: Deprecated TransportMessage
      - Url: nservicebus/upgrades/5to6/distributor
        Title: Distributor
      - Url: nservicebus/upgrades/5to6/extension-seams
        Title: Extension Seams
      - Url: nservicebus/upgrades/5to6/dependency-injection
        Title: Dependency Injection
      - Url: nservicebus/upgrades/5to6/tools-and-helpers
        Title: Tools and Helpers
    - Url: nservicebus/upgrades/4to5
      Title: NServiceBus 4 to 5
    - Url: nservicebus/upgrades/3to4
      Title: NServiceBus 3 to 4
    - Url: nservicebus/upgrades/callbacks-1to2
      Title: Callbacks 1 to 2
    - Title: Metrics
      Articles:
      - Url: nservicebus/upgrades/metrics-1to2
        Title: Version 1 to 2
      - Url: nservicebus/upgrades/metrics-1to1.1
        Title: Version 1 to 1.1
    - Title: Azure BlobStorage Data Bus
      Articles:
      - Url: nservicebus/upgrades/absdatabus-6to7
        Title: Version 6 to 7
      - Url: nservicebus/upgrades/absdatabus-3to4
        Title: Version 3 to 4
      - Url: nservicebus/upgrades/absdatabus-2to3
        Title: Version 2 to 3
      - Url: nservicebus/upgrades/absdatabus-1to2
        Title: Version 1 to 2
      - Url: nservicebus/upgrades/absdatabus-6to1
        Title: Migrating off NServiceBus.Azure
    - Title: Gateway
      Articles:
      - Url: nservicebus/upgrades/gateway-3to4
        Title: Version 3 to 4
      - Url: nservicebus/upgrades/gateway-2to3
        Title: Version 2 to 3
      - Url: nservicebus/upgrades/gateway-1to2
        Title: Version 1 to 2
    - Title: Messaging Bridge
      Articles:
      - Url: nservicebus/upgrades/bridge-3to4
        Title: Messaging Bridge 3 to 4
      - Url: nservicebus/upgrades/bridge-2to3
        Title: Messaging Bridge 2 to 3
    - Title: System.Text.Json Serializer
      Articles:
      - Url: nservicebus/upgrades/community-system-json
        Title: From community package
    - Title: Newtonsoft Serializer
      Articles:
      - Url: nservicebus/upgrades/newtonsoft-2to3
        Title: Version 2 to 3
    - Title: NServiceBus Testing
      Articles:
      - Url: nservicebus/upgrades/testing-7to8
        Title: Version 7 to 8
      - Url: nservicebus/upgrades/testing-6to7
        Title: Version 6 to 7
      - Url: nservicebus/upgrades/testing-5to6
        Title: Version 5 to 6
    - Title: Message Property Encryption
      Articles:
      - Url: nservicebus/upgrades/message-property-encryption-3.1to4
        Title: Version 3.1 to 4
      - Url: nservicebus/upgrades/message-property-encryption-3to3.1
        Title: Version 3 to 3.1
      - Url: nservicebus/upgrades/externalize-encryption
        Title: Migrate To External Nuget
    - Title: Performance Counters
      Articles:
      - Url: nservicebus/upgrades/perfcounters-3to4
        Title: Version 3 to 4
      - Url: nservicebus/upgrades/perfcounters-1to2
        Title: Version 1 to 2
      - Url: nservicebus/upgrades/externalize-perfcounters
        Title: Migrate To External Nuget
    - Title: ServicePlatform Connector
      Articles:
      - Url: nservicebus/upgrades/service-platform-connector-3to4
        Title: Version 3 to 4
    - Title: ServiceControl Plugins
      Articles:
      - Url: nservicebus/upgrades/nsb6-sc-plugins-1to2
        Title: Version 1 to 2
      - Url: nservicebus/upgrades/nservicebus.sagaaudit
        Title: ServiceControl.Plugin.X.SagaAudit to NServiceBus.SagaAudit
      - Url: nservicebus/upgrades/nservicebus.customchecks
        Title: ServiceControl.Plugin.X.CustomChecks to NServiceBus.CustomChecks
      - Url: nservicebus/upgrades/nservicebus.heartbeat
        Title: ServiceControl.Plugin.X.Heartbeat to NServiceBus.Heartbeat
  - Title: Messaging
    Articles:
    - Url: nservicebus/messaging
      Title: About messaging
    - Url: nservicebus/messaging/messages-events-commands
      Title: Messages, Events and Commands
      Articles:
      - Url: nservicebus/messaging/message-identity
        Title: Message Identity
      - Url: nservicebus/messaging/message-type-detection
        Title: Message type detection
      - Url: nservicebus/messaging/messages-as-interfaces
        Title: Interfaces as messages
      - Url: nservicebus/messaging/dynamic-dispatch-and-routing
        Title: Dynamic dispatch and polymorphic routing
      - Url: nservicebus/messaging/conventions
        Title: Conventions
      - Url: nservicebus/messaging/unobtrusive-mode
        Title: Unobtrusive Mode
      - Url: nservicebus/messaging/immutable-messages
        Title: Immutable messages
      - Url: nservicebus/messaging/best-practice-enforcement
        Title: Best practice enforcement
      - Url: nservicebus/messaging/sharing-contracts
        Title: Sharing message contracts
    - Title: Evolving systems
      Articles:
      - Url: nservicebus/messaging/moving-handlers
        Title: Moving Handlers
      - Url: nservicebus/messaging/evolving-contracts
        Title: Evolving contracts
    - Url: nservicebus/messaging/send-a-message
      Title: Sending messages
      Articles:
      - Url: nservicebus/messaging/reply-to-a-message
        Title: Replying
      - Url: nservicebus/messaging/batched-dispatch
        Title: Batched message dispatch
      - Url: nservicebus/messaging/callbacks
        Title: Client side Callbacks
      - Url: nservicebus/messaging/uniformsession
        Title: Uniform Session between message session and pipeline
      - Url: nservicebus/messaging/discard-old-messages
        Title: Discarding Expired Messages
      - Url: nservicebus/messaging/non-durable-messaging
        Title: Non-Durable Messaging
      - Url: nservicebus/messaging/forwarding
        Title: Forwarding
    - Url: nservicebus/messaging/delayed-delivery
      Title: Delayed Delivery
      Articles:
      - Url: nservicebus/messaging/timeout-manager
        Title: Timeout Manager
    - Url: nservicebus/messaging/publish-subscribe
      Title: Publish Subscribe
      Articles:
      - Url: nservicebus/messaging/publish-subscribe/publish-handle-event
        Title: Publish and Handle an Event
      - Url: nservicebus/messaging/publish-subscribe/controlling-what-is-subscribed
        Title: Subscription configuration
    - Url: nservicebus/messaging/headers
      Title: Message Headers
      Articles:
      - Url: nservicebus/messaging/header-manipulation
        Title: Header Manipulation
      - Url: nservicebus/messaging/third-party-integration
        Title: Third Party Integration
    - Url: nservicebus/endpoints/specify-endpoint-name
      Title: Specify Endpoint Name
    - Url: nservicebus/messaging/routing
      Title: Routing
      Articles:
      - Url: nservicebus/messaging/routing-extensibility
        Title: Routing extensibility points
    - Url: nservicebus/scheduling
      Title: Scheduling
    - Url: nservicebus/gateway
      Title: Gateway
      Articles:
      - Url: nservicebus/gateway/multi-site-deployments
        Title: Multi-Site Deployments
      - Url: nservicebus/gateway/sql
        Title: SQL deduplication storage
      - Url: nservicebus/gateway/ravendb
        Title: RavenDB deduplication storage
      - Url: nservicebus/gateway/troubleshooting
        Title: Troubleshooting
      - Url: nservicebus/gateway/scale-out
        Title: Scale-Out
    - Url: nservicebus/rawmessaging
      Title: Raw messaging
    - Url: nservicebus/outbox
      Title: Outbox
    - Url: nservicebus/transactional-session
      Title: Transactional session
      Articles:
        - Url: nservicebus/transactional-session/persistences/azure-table
          Title: Azure Table Persistence
        - Url: nservicebus/transactional-session/persistences/cosmosdb
          Title: CosmosDB Persistence
        - Url: nservicebus/transactional-session/persistences/mongodb
          Title: MongoDB Persistence
        - Url: nservicebus/transactional-session/persistences/dynamodb
          Title: DynamoDB Persistence
        - Url: nservicebus/transactional-session/persistences/sql-persistence
          Title: SQL Persistence
        - Url: nservicebus/transactional-session/persistences/nhibernate
          Title: NHibernate Persistence
        - Url: nservicebus/transactional-session/persistences/ravendb
          Title: RavenDB Persistence
    - Url: nservicebus/messaging/claimcheck
      Title: Data Bus
      Articles:
      - Url: nservicebus/messaging/claimcheck/file-share
        Title: File Share
      - Url: nservicebus/messaging/claimcheck/azure-blob-storage
        Title: Azure Blob Storage
      - Url: nservicebus/messaging/claimcheck/binary
        Title: DataBus binary serializer
      - Url: nservicebus/messaging/claimcheck/custom
        Title: Customizing DataBus
  - Title: Handlers and sagas
    Articles:
    - Url: nservicebus/handlers-and-sagas
      Title: About handlers and sagas
    - Url: nservicebus/handlers/async-handlers
      Title: Asynchronous Handlers
    - Url: nservicebus/handlers
      Title: Handlers
      Articles:
      - Url: nservicebus/handlers/accessing-data
        Title: Accessing data
      - Url: nservicebus/handlers/handler-ordering
        Title: Handler Order
    - Url: nservicebus/sagas
      Title: Sagas
      Articles:
      - Url: nservicebus/sagas/message-correlation
        Title: Message Correlation
      - Url: nservicebus/sagas/timeouts
        Title: Timeouts
      - Url: nservicebus/sagas/saga-not-found
        Title: Not Found
      - Url: nservicebus/sagas/concurrency
        Title: Concurrency
      - Url: nservicebus/sagas/analyzers
        Title: Roslyn analyzers
      - Url: nservicebus/sagas/reply-replytooriginator-differences
        Title: Reply and ReplyToOriginator differences
      - Url: nservicebus/sagas/saga-audit
        Title: Debugging sagas in ServicePulse
      - Url: nservicebus/sagas/saga-finding
        Title: Complex finding logic
  - Title: Testing
    Articles:
    - Url: nservicebus/testing
      Title: About testing NServiceBus
    - Url: nservicebus/testing/saga-scenario-testing
      Title: Saga scenario testing
    - Url: nservicebus/testing/fluent
      Title: Fluent style tests
    - Url: nservicebus/messaging/callbacks-testing
      Title: Callbacks
    - Url: nservicebus/messaging/uniformsession-testing
      Title: Uniform session
  - Title: Recoverability
    Articles:
    - Url: nservicebus/recoverability
      Title: About recoverability with NServiceBus
    - Url: nservicebus/recoverability/configure-error-handling
      Title: Configure error handling
    - Url: nservicebus/recoverability/configure-immediate-retries
      Title: Configure immediate retries
    - Url: nservicebus/recoverability/configure-delayed-retries
      Title: Configure delayed retries
    - Url: nservicebus/recoverability/exception-caveats
      Title: Exception Caveats
    - Url: nservicebus/recoverability/custom-recoverability-policy
      Title: Custom Policy
    - Url: nservicebus/recoverability/subscribing-to-error-notifications
      Title: Error notifications
    - Url: nservicebus/recoverability/pipeline
      Title: Recoverability pipeline
  - Title: Pipeline
    Articles:
    - Url: nservicebus/pipeline
      Title: About message handling pipeline
    - Url: nservicebus/pipeline/steps-stages-connectors
      Title: Steps, Stages and Connectors
    - Url: nservicebus/pipeline/manipulate-with-behaviors
      Title: Manipulate with Behaviors
    - Url: nservicebus/pipeline/message-mutators
      Title: Message Mutators
    - Url: nservicebus/pipeline/unit-of-work
      Title: Unit of Work
    - Url: nservicebus/pipeline/aborting
      Title: Abort execution
    - Url: nservicebus/pipeline/events
      Title: Subscribing to notification events
    - Url: nservicebus/pipeline/features
      Title: Features
    - Url: nservicebus/satellites
      Title: Satellites
  - Title: Serialization
    Articles:
    - Url: nservicebus/serialization
      Title: About serialization with NServiceBus
    - Url: nservicebus/serialization/system-json
      Title: System.Text.Json
    - Url: nservicebus/serialization/newtonsoft
      Title: Json.NET
    - Url: nservicebus/serialization/xml
      Title: Xml
    - Url: nservicebus/serialization/custom-serializer
      Title: Custom
  - Title: Message Envelopes
    Articles:
    - Url: nservicebus/cloudevents
      Title: CloudEvents
  - Title: Dependency Injection
    Articles:
    - Url: nservicebus/dependency-injection
      Title: About NServiceBus and dependency injection
    - Url: nservicebus/dependency-injection/child-lifetime
      Title: Child Lifetimes
    - Url: nservicebus/dependency-injection/extensions-dependencyinjection
      Title: Microsoft.Extensions.DependencyInjection
    - Url: nservicebus/dependency-injection/autofac
      Title: Autofac
    - Url: nservicebus/dependency-injection/castlewindsor
      Title: Castle Windsor
    - Url: nservicebus/dependency-injection/ninject
      Title: Ninject
    - Url: nservicebus/dependency-injection/spring
      Title: Spring
    - Url: nservicebus/dependency-injection/structuremap
      Title: StructureMap
    - Url: nservicebus/dependency-injection/unity
      Title: Unity
  - Title: Logging
    Articles:
    - Url: nservicebus/logging
      Title: About NServiceBus logging
    - Url: nservicebus/logging/extensions-logging
      Title: Extensions.Logging
    - Url: nservicebus/logging/log4net
      Title: Log4Net
    - Url: nservicebus/logging/nlog
      Title: NLog
    - Url: nservicebus/logging/common-logging
      Title: CommonLogging
    - Url: nservicebus/operations/auditing
      Title: Auditing Messages
  - Title: Security
    Articles:
    - Url: nservicebus/security
      Title: About security and NServiceBus
    - Url: nservicebus/security/generating-encryption-keys
      Title: Generating secure random strong encryption keys
  - Title: Security Advisories
    Articles:
    - Url: security-advisories
      Title: About
    - Url: security-advisories/cryptography-xml-vulnerability
      Title: 2022-12-06
    - Url: security-advisories/servicepulse-directorytraversal
      Title: 2020-03-11
    - Url: security-advisories/msmq-permissions
      Title: 2017-01-10
    - Url: security-advisories/sqlserver-sqlinjection
      Title: 2016-07-05
  - Title: Operations
    Articles:
    - Url: nservicebus/hosting/startup-diagnostics
      Title: Startup diagnostics
    - Url: nservicebus/operations/opentelemetry
      Title: OpenTelemetry
    - Url: nservicebus/operations/transactions-message-processing
      Title: Transactions and Message Processing
    - Url: nservicebus/operations/auditing
      Title: Auditing Messages
    - Url: nservicebus/security/property-encryption
      Title: Message Property Encryption
    - Url: nservicebus/operations/configuring-aws
      Title: NServiceBus in AWS
    - Url: nservicebus/operations/dotnet-framework-version-requirements
      Title: .NET Framework requirements
    - Url: nservicebus/operations/installers
      Title: Installers
    - Url: nservicebus/operations/tuning
      Title: Tuning endpoint message processing
    - Url: nservicebus/endpoints/decommissioning-endpoints
      Title: Decommissioning Endpoints
    - Url: nservicebus/operations/nservicebus-analyzer
      Title: NServiceBus Analyzer
  - Title: Messaging Bridge
    Articles:
    - Url: nservicebus/bridge
      Title: NServiceBus messaging bridge
    - Url: nservicebus/bridge/configuration
      Title: Configuration
    - Url: nservicebus/bridge/scenarios
      Title: Usage scenarios
      Articles:
      - Url: nservicebus/bridge/migrating-from-router
        Title: Migrating from Router
    - Url: nservicebus/bridge/performance
      Title: Performance & scaling
  - Title: Compliance
    Articles:
    - Url: nservicebus/compliance
      Title: Compliance and NServiceBus
    - Url: nservicebus/compliance/gdpr
      Title: GDPR
    - Url: nservicebus/compliance/fips
      Title: FIPS
    - Url: nservicebus/compliance/software-supply-chain
      Title: Software supply chain
  - Title: Tools
    Articles:
    - Url: nservicebus/tools
      Title: Overview
    - Url: nservicebus/tools/migrate-to-native-delivery
      Title: Migrating timeouts
    - Url: nservicebus/throughput-tool
      Title: Measuring usage using legacy tool
  - Title: Troubleshooting
    Articles:
    - Url: nservicebus/troubleshooting/message-loss
      Title: Message loss

- Name: Transports
  Url: transports
  Topics:
  - Title: General
    Articles:
    - Url: transports
      Title: NServiceBus and transports
    - Url: transports/selecting
      Title: Selecting a transport
    - Url: transports/types
      Title: Transport types
    - Url: transports/transactions
      Title: Transactions
    - Url: transports/queuecreation
      Title: Creating queues
  - Title: Upgrade Guides
    Articles:
    - Title: Azure Storage Queues
      Articles:
      - Url: transports/upgrades/asq-11to12
        Title: Version 11 to 12
      - Url: transports/upgrades/asq-10to11
        Title: Version 10 to 11
      - Url: transports/upgrades/asq-9to10
        Title: Version 9 to 10
      - Url: transports/upgrades/asq-8to9
        Title: Version 8 to 9
      - Url: transports/upgrades/asq-7to8
        Title: Version 7 to 8
      - Url: transports/upgrades/asq-6to7
        Title: Version 6 to 7
    - Title: Azure Service Bus
      Articles:
      - Url: transports/upgrades/asbs-5to6
        Title: Version 5 to 6
      - Url: transports/upgrades/asbs-4to5
        Title: Version 4 to 5
      - Url: transports/upgrades/asbs-3to4
        Title: Version 3 to 4
      - Url: transports/upgrades/asbs-2to3
        Title: Version 2 to 3
      - Url: transports/upgrades/asbs-1to2
        Title: Version 1 to 2
      - Url: transports/upgrades/asbs-1.7to1.8
        Title: Version 1.7 to 1.8
    - Title: Azure Service Bus (Legacy)
      Articles:
      - Url: transports/upgrades/asb-10toasbs-1
        Title: Version 10 to ASB 1
      - Url: transports/upgrades/asb-9to10
        Title: Version 9 to 10
      - Url: transports/upgrades/asb-9to9.1
        Title: Version 9 to 9.1
      - Url: transports/upgrades/asb-8to9
        Title: Version 8 to 9
      - Url: transports/upgrades/asb-7to8
        Title: Version 7 to 8
      - Url: transports/upgrades/asb-6to7
        Title: Version 6 to 7
    - Title: RabbitMQ
      Articles:
      - Url: transports/upgrades/rabbitmq-10to11
        Title: Version 10 to 11
      - Url: transports/upgrades/rabbitmq-9to10
        Title: Version 9 to 10
      - Url: transports/upgrades/rabbitmq-7to8
        Title: Version 7 to 8
      - Url: transports/upgrades/rabbitmq-classic-to-quorum-migration
        Title: Migrating from classic queues to quorum queues
      - Url: transports/upgrades/rabbitmq-6to7
        Title: Version 6 to 7
      - Url: transports/upgrades/rabbitmq-5to6
        Title: Version 5 to 6
      - Url: transports/upgrades/rabbitmq-4to5
        Title: Version 4 to 5
      - Url: transports/upgrades/rabbitmq-4.0to4.1
        Title: Version 4.0 to 4.1
      - Url: transports/upgrades/rabbitmq-3to4
        Title: Version 3 to 4
    - Title: SQL Server
      Articles:
      - Url: transports/upgrades/sqlserver-7to8
        Title: Version 7 to 8
      - Url: transports/upgrades/sqlserver-client4
        Title: Microsoft.Data.SqlClient version 4
      - Url: transports/upgrades/sqlserver-6to7
        Title: Version 6 to 7
      - Url: transports/upgrades/sqlserver-non-clustered-idx
        Title: Non-clustered index in the input queue
      - Url: transports/upgrades/sqlserver-5to6
        Title: Version 5 to 6
      - Url: transports/upgrades/sqlserver-4to5
        Title: Version 4 to 5
      - Url: transports/upgrades/sqlserver-31to4
        Title: Version 3.1 to 4
      - Url: transports/upgrades/sqlserver-3to31
        Title: Version 3 to 3.1
      - Url: transports/upgrades/sqlserver-unicode-headers
        Title: Unicode characters in headers
      - Url: transports/upgrades/sqlserver-2to3
        Title: Version 2 to 3
      - Url: transports/upgrades/sqlserver-2.x-2.2.4
        Title: Version 2.x to 2.2.4
      - Url: transports/upgrades/sqlserver-1.x-1.2.5
        Title: Version 1.x to 1.2.5
    - Title: Amazon SQS
      Articles:
      - Url: transports/upgrades/amazonsqs-7to8
        Title: Version 7 to 8
      - Url: transports/upgrades/amazonsqs-6to7
        Title: Version 6 to 7
      - Url: transports/upgrades/amazonsqs-5to6
        Title: Version 5 to 6
      - Url: transports/upgrades/amazonsqs-4to5
        Title: Version 4 to 5
      - Url: transports/upgrades/amazonsqs-3to4
        Title: Version 3 to 4
      - Url: transports/upgrades/amazonsqs-2to3
        Title: Version 2 to 3
      - Url: transports/upgrades/amazonsqs-1to3
        Title: Version 1 to 3
    - Title: MSMQ
      Articles:
      - Url: transports/upgrades/msmq-1to2
        Title: Version 1 to 2
      - Url: transports/upgrades/msmq-2to2.0.4
        Title: Version 2 to 2.0.4
  - Title: Learning
    Articles:
    - Url: transports/learning
      Title: Learning transport
    - Url: transports/learning/viewing-messages
      Title: Viewing content
  - Title: Azure Service Bus
    Articles:
    - Url: transports/azure-service-bus
      Title: Azure Service Bus transport
    - Url: transports/azure-service-bus/configuration
      Title: Configuration
    - Url: transports/azure-service-bus/native-message-access
      Title: Native message access
    - Url: transports/azure-service-bus/compatibility
      Title: Backwards compatibility
    - Url: transports/azure-service-bus/native-integration
      Title: Native Integration
    - Url: transports/azure-service-bus/topology
      Title: Topology
    - Url: transports/azure-service-bus/transaction-support
      Title: Transaction support
      Articles:
        - Url: nservicebus/azure/ways-to-live-without-transactions
          Title: Avoiding Transactions
    - Url: transports/azure-service-bus/queue-scoped-permissions
      Title: Queue-scoped permissions
    - Url: transports/azure-service-bus/operational-scripting
      Title: Operational scripting
  - Title: Azure Storage Queues
    Articles:
    - Url: transports/azure-storage-queues
      Title: Azure Storage Queues transport
    - Url: transports/azure-storage-queues/transaction-support
      Title: Transaction Support
      Articles:
        - Url: nservicebus/azure/ways-to-live-without-transactions
          Title: Avoiding Transactions
    - Url: transports/azure-storage-queues/configuration
      Title: Configuration
    - Url: transports/azure-storage-queues/delayed-delivery
      Title: Delayed Delivery
    - Url: transports/azure-storage-queues/native-integration
      Title: Native Integration
    - Url: transports/azure-storage-queues/native-message-access
      Title: Native Message Access
    - Url: transports/azure-storage-queues/native-publish-subscribe
      Title: Native Publish Subscribe
    - Url: transports/azure-storage-queues/sanitization
      Title: Sanitization
    - Url: transports/azure-storage-queues/operations-scripting
      Title: Operations Scripting
    - Url: transports/azure-storage-queues/performance-tuning
      Title: Performance Tuning
    - Url: transports/azure-storage-queues/multi-storageaccount-support
      Title: Multiple storage accounts
    - Url: transports/azure-storage-queues/troubleshooting
      Title: Troubleshooting
  - Title: SQL Server
    Articles:
    - Url: transports/sql
      Title: SQL Server transport
    - Url: transports/sql/design
      Title: Design
    - Url: transports/sql/native-publish-subscribe
      Title: Native publish/subscribe
    - Url: transports/sql/native-delayed-delivery
      Title: Native delayed delivery
    - Url: transports/sql/connection-settings
      Title: Connection settings
    - Url: transports/sql/addressing
      Title: Addressing
    - Url: transports/sql/transactions
      Title: Transaction support
    - Url: persistence/sql/sqlserver-combining-persistence-wth-transport
      Title: Combining with SQL Server Persistence
    - Url: transports/sql/discard-expired-messages
      Title: Discarding expired messages
    - Url: transports/sql/native-integration
      Title: Native integration
    - Url: transports/sql/deployment-options
      Title: Deployment options
    - Url: transports/sql/operations-scripting
      Title: Transport scripting
    - Url: transports/sql/sql-statements
      Title: SQL statements
    - Url: transports/sql/entity-framework
      Title: Entity Framework caveats
    - Url: transports/sql/callbacks
      Title: Callback support
    - Url: transports/sql/sql-azure
      Title: Azure SQL considerations
    - Url: transports/sql/azure-sql-failover
      Title: Azure SQL failover
    - Url: transports/sql/troubleshooting
      Title: Troubleshooting
  - Title: PostgreSQL
    Articles:
    - Url: transports/postgresql
      Title: PostgreSQL transport
    - Url: transports/postgresql/design
      Title: Design
    - Url: transports/postgresql/native-publish-subscribe
      Title: Native publish/subscribe
    - Url: transports/postgresql/connection-settings
      Title: Connection settings
    - Url: transports/postgresql/addressing
      Title: Addressing
    - Url: transports/postgresql/transactions
      Title: Transaction support
    - Url:  persistence/sql/postgresql-combining-persistence-with-transport
      Title: Combining with PostgreSQL Persistence
  - Title: MSMQ
    Articles:
    - Url: transports/msmq
      Title: MSMQ transport
    - Url: transports/msmq/routing
      Title: Physical routing
      Articles:
      - Url: transports/msmq/routing-extensibility
        Title: Routing extensibility
    - Url: transports/msmq/connection-strings
      Title: Connection strings
    - Url: transports/msmq/dead-letter-queues
      Title: Dead Letter Queues
    - Url: transports/msmq/viewing-message-content-in-msmq
      Title: Viewing content
    - Url: transports/msmq/transportconfig
      Title: Configuration
      Articles:
      - Url: transports/msmq/discard-expired-messages
        Title: Discarding expired messages
      - Url: transports/msmq/delayed-delivery
        Title: Delayed delivery
    - Url: transports/msmq/troubleshooting
      Title: Troubleshooting
    - Url: transports/msmq/subscription-authorisation
      Title: Subscription Authorization
    - Url: transports/msmq/management-using-powershell
      Title: PowerShell
    - Url: transports/msmq/native-integration
      Title: Native integration
    - Url: transports/msmq/operations-scripting
      Title: Scripting
    - Url: transports/msmq/uninstalling-msmq
      Title: Uninstalling MSMQ
    - Url: transports/msmq/full-qualified-domain-name
      Title: Fully Qualified Domain Names
    - Url: transports/msmq/scaling-out
      Title: Scaling out
    - Url: transports/msmq/sender-side-distribution
      Title: Scaling out with Sender-Side Distribution
  - Title: IBM MQ
    Articles:
    - Url: transports/ibmmq
      Title: IBM MQ transport
    - Url: transports/ibmmq/connection-settings
      Title: Connection settings
    - Url: transports/ibmmq/topology
      Title: Publish/subscribe topology
    - Url: transports/ibmmq/transactions
      Title: Transaction support
    - Url: transports/ibmmq/native-integration
      Title: Native integration
    - Url: transports/ibmmq/observability
      Title: Observability
    - Url: transports/ibmmq/security
      Title: Security and permissions
    - Url: transports/ibmmq/operations-scripting
      Title: Scripting
  - Title: RabbitMQ
    Articles:
    - Url: transports/rabbitmq
      Title: RabbitMQ transport
    - Url: transports/rabbitmq/connection-settings
      Title: Connection settings
    - Url: transports/rabbitmq/routing-topology
      Title: Routing topology
    - Url: transports/rabbitmq/delayed-delivery
      Title: Delayed delivery
    - Url: transports/rabbitmq/native-integration
      Title: Native integration
    - Url: transports/rabbitmq/transactions-and-delivery-guarantees
      Title: Transactions and delivery guarantees
    - Url: transports/rabbitmq/operations-scripting
      Title: Scripting
  - Title: Amazon SQS
    Articles:
    - Url: transports/sqs
      Title: Amazon SQS transport
    - Url: transports/sqs/configuration-options
      Title: Configuration Options
    - Url: transports/sqs/delayed-delivery
      Title: Delayed Delivery
    - Url: transports/sqs/topology
      Title: Topology
    - Url: transports/sqs/transaction-support
      Title: Transaction
    - Url: transports/sqs/native-integration
      Title: Native Integration
    - Url: transports/sqs/operations-scripting
      Title: Scripting
    - Url: nservicebus/aws/local-development
      Title: Local development
    - Url: transports/sqs/troubleshooting
      Title: Troubleshooting

- Name: Persistence
  Topics:
  - Title: General
    Articles:
    - Url: persistence
      Title: NServiceBus and persistence
    - Url: persistence/selecting
      Title: Selecting a persister
    - Url: persistence/order
      Title: Persistence order
  - Title: Upgrade Guides
    Articles:
    - Title: Azure Table
      Articles:
      - Url: persistence/upgrades/asp-6to7
        Title: Version 6 to 7
      - Url: persistence/upgrades/asp-4to5
        Title: Version 4 to 5
      - Url: persistence/upgrades/asp-2to3
        Title: Version 2 to 3
      - Url: persistence/upgrades/asp-1to2
        Title: Version 1 to 2
      - Url: persistence/upgrades/asp-6to1
        Title: Legacy Version 6 to Version 1
      - Url: persistence/upgrades/asp-saga-pruning
        Title: Legacy Version 6.2.4 to 6.2.5
      - Url: persistence/upgrades/asp-saga-deduplication
        Title: Legacy Version 6.2.3 to 6.2.4
    - Title: Cosmos DB
      Articles:
      - Url: persistence/upgrades/cosmosdb-1to2
        Title: Version 1 to 2
      - Url: persistence/upgrades/cosmosdb-3to4
        Title: Version 3 to 4
    - Title: DynamoDB
      Articles:
      - Url: persistence/upgrades/dynamodb-2to3
        Title: Version 2 to 3
    - Title: NHibernate
      Articles:
      - Url: persistence/upgrades/nhibernate-10to11
        Title: Version 10 to 11
      - Url: persistence/upgrades/nhibernate-8to9
        Title: Version 8 to 9
      - Url: persistence/upgrades/nhibernate-8to8.1
        Title: Version 8 to 8.1
      - Url: persistence/upgrades/nhibernate-6to7
        Title: Version 6 to 7
      - Url: persistence/upgrades/nhibernate-timeouts-index
        Title: Resolving incorrect timeout table indexes
      - Url: persistence/upgrades/nhibernate-saga-index-fix
        Title: Adding unique constraints on saga data tables
    - Title: MongoDB
      Articles:
      - Url: persistence/upgrades/mongodb-4to5
        Title: Version 4 to 5
      - Url: persistence/upgrades/mongodb-5to6
        Title: Version 5 to 6
    - Title: RavenDB
      Articles:
      - Url: persistence/upgrades/ravendb-9to10
        Title: Version 9 to 10
      - Url: persistence/upgrades/ravendb-7to8
        Title: Version 7 to 8
      - Url: persistence/upgrades/ravendb-6to7
        Title: Version 6 to 7
      - Url: persistence/upgrades/ravendb-6.2to6.3
        Title: Version 6.2 to 6.3
      - Url: persistence/upgrades/ravendb-5to6
        Title: Version 5 to 6
      - Url: persistence/upgrades/ravendb-4to5
        Title: Version 4 to 5
      - Url: persistence/upgrades/ravendb-3to4
        Title: Version 3 to 4
    - Title: RavenDB Gateway Storage
      Articles:
      - Url: persistence/upgrades/ravendb-gateway-4to5
        Title: Version 4 to 5
      - Url: persistence/upgrades/ravendb-gateway-1to2
        Title: Version 1 to 2
    - Title: SQL
      Articles:
      - Url: persistence/upgrades/sql-8to9
        Title: Version 8 to 9
      - Url: persistence/upgrades/sql-6to7
        Title: Version 6 to 7
      - Url: persistence/upgrades/sql-5to6
        Title: Version 5 to 6
      - Url: persistence/upgrades/sql-4to5
        Title: Version 4 to 5
      - Url: persistence/upgrades/sql-4.2to4.3
        Title: Version 4.2 to 4.3
      - Url: persistence/upgrades/sql-4.0to4.1.1
        Title: Version 4.0 to 4.1.1
      - Url: persistence/upgrades/sql-2to3
        Title: Version 2 to 3
      - Url: persistence/upgrades/sql-1to2
        Title: Version 1 to 2
      - Url: persistence/upgrades/sql-1.0.0-1.0.1
        Title: Version 1 to 1.0.1
      - Url: persistence/upgrades/sql-client4
        Title: Microsoft.Data.SqlClient version 4
      - Url: persistence/upgrades/sql-null-endpoint
        Title: Support NServiceBus 5 subscribers
  - Title: Learning
    Articles:
    - Url: persistence/learning
      Title: Overview
  - Title: Non-Durable
    Articles:
    - Url: persistence/non-durable
      Title: Overview
    - Url: persistence/non-durable/gateway-deduplication
      Title: Gateway Deduplication
  - Title: SQL
    Articles:
    - Url: persistence/sql
      Title: Overview
    - Url: persistence/sql/dialect-mssql
      Title: SQL Server
      Articles:
      - Url: persistence/sql/sqlserver-combining-persistence-wth-transport
        Title: Combining with SQL Server Transport
      - Url: persistence/sql/sqlserver-scripts
        Title: Scripts
    - Url: persistence/sql/dialect-mysql
      Title: MySQL
      Articles:
      - Url: persistence/sql/mysql-scripts
        Title: Scripts
    - Url: persistence/sql/dialect-oracle
      Title: Oracle
      Articles:
      - Url: persistence/sql/oracle-scripts
        Title: Scripts
    - Url: persistence/sql/dialect-postgresql
      Title: PostgreSQL
      Articles:
      - Url: persistence/sql/postgresql-scripts
        Title: Scripts
      - Url:  persistence/sql/postgresql-combining-persistence-with-transport
        Title: Combining with PostgreSQL Transport
    - Url: persistence/sql/controlling-script-generation
      Title: Script generation
      Articles:
      - Url: persistence/sql/operational-scripting
        Title: Operational Scripting
    - Url: persistence/sql/accessing-data
      Title: Business data
    - Url: persistence/sql/saga
      Title: Sagas
      Articles:
      - Url: persistence/sql/saga-finder
        Title: Saga finders
      - Url: persistence/sql/saga-concurrency
        Title: Saga concurrency
      - Url: persistence/sql/sqlsaga
        Title: SqlSaga base class (Legacy)
    - Url: persistence/sql/subscriptions
      Title: Subscriptions
    - Url: persistence/sql/timeouts
      Title: Timeouts
    - Url: persistence/sql/outbox
      Title: Outbox
    - Url: persistence/sql/multi-tenant
      Title: Multi-tenant support
    - Url: persistence/sql/install
      Title: Installation and deployment
    - Url: persistence/sql/installer-workflow
      Title: Installer Workflow
    - Url: persistence/sql/migrating-from-nhibernate
      Title: Migrating from NHibernate
    - Url: persistence/sql/troubleshooting
      Title: Troubleshooting
  - Title: Cosmos DB
    Articles:
    - Title: Overview
      Url: persistence/cosmosdb
    - Title: Saga concurrency
      Url: persistence/cosmosdb/saga-concurrency
    - Title: Saga timeouts
      Url: persistence/cosmosdb/saga-timeouts
    - Title: Transactions
      Url: persistence/cosmosdb/transactions
    - Title: Migration from Azure Table Persistence
      Url: persistence/cosmosdb/migration-from-azure-table
  - Title: Azure Table
    Articles:
    - Url: persistence/azure-table
      Title: Overview
    - Url: persistence/azure-table/configuration
      Title: Configuration
    - Url: persistence/azure-table/transactions
      Title: Transactions
    - Url: persistence/azure-table/performance-tuning
      Title: Performance Tuning
    - Url: persistence/azure-table/scripting
      Title: Scripting
    - Title: Migration from Azure Table Storage to Cosmos DB Table API
      Url: persistence/azure-table/migration-from-azure-storage-table-to-cosmos-table
    - Url: persistence/azure-table/capacity-planning
      Title: Capacity planning

  - Title: RavenDB
    Articles:
    - Url: persistence/ravendb
      Title: Overview
    - Url: persistence/ravendb/connection
      Title: Connection options
    - Url: persistence/ravendb/saga-concurrency
      Title: Saga concurrency
    - Url: persistence/ravendb/operations-scripting
      Title: Scripting
    - Url: persistence/ravendb/installation
      Title: Installation
    - Url: persistence/ravendb/outbox
      Title: Outbox
    - Url: persistence/ravendb/reroute-existing-timeouts
      Title: Reroute existing timeouts
    - Url: persistence/ravendb/dtc
      Title: DTC not supported
    - Url: persistence/ravendb/cluster-configuration
      Title: Cluster configurations
  - Title: Service Fabric
    Articles:
    - Url: persistence/service-fabric
      Title: Overview
    - Url: persistence/service-fabric/sagas
      Title: Sagas
    - Url: persistence/service-fabric/outbox
      Title: Outbox
    - Url: persistence/service-fabric/transaction-sharing
      Title: Transaction Sharing
  - Title: NHibernate
    Articles:
    - Url: persistence/nhibernate
      Title: Overview
    - Url: persistence/nhibernate/accessing-data
      Title: Business data
    - Url: persistence/nhibernate/saga-concurrency
      Title: Saga concurrency
    - Url: persistence/nhibernate/outbox
      Title: Outbox
    - Url: persistence/nhibernate/sql-azure
      Title: SQL Azure
    - Url: persistence/nhibernate/scripting
      Title: Scripting
  - Title: MSMQ Subscription
    Articles:
    - Url: persistence/msmq
      Title: Overview
  - Title: MongoDB
    Articles:
    - Url: persistence/mongodb
      Title: Overview
    - Url: persistence/mongodb/document-version
      Title: How document versioning works
    - Url: persistence/mongodb/migrating-from-sbmako
      Title: Migrating from NServicebus.MongoDB
    - Url: persistence/mongodb/migrating-from-tekmaven
      Title: Migrating from NServiceBus.Persistence.MongoDB
  - Title: DynamoDB
    Articles:
    - Url: persistence/dynamodb
      Title: Overview
    - Url: persistence/dynamodb/sagas
      Title: Sagas
    - Url: persistence/dynamodb/outbox
      Title: Outbox
    - Url: persistence/dynamodb/transactions
      Title: Transactions
    - Url: nservicebus/aws/local-development
      Title: Local development
    - Url: persistence/dynamodb/capacity-planning
      Title: Capacity planning

- Name: Hosting
  Topics:
  - Title: General
    Articles:
    - Url: nservicebus/hosting
      Title: About hosting
    - Url: nservicebus/endpoints
      Title: Endpoints
    - Url: nservicebus/hosting/selecting
      Title: Selecting a host
    - Url: nservicebus/hosting/override-hostid
      Title: Overriding the host identifier
    - Url: nservicebus/hosting/override-machine-name
      Title: Overriding the machine name
    - Url: nservicebus/hosting/assembly-scanning
      Title: Assembly scanning
    - Url: nservicebus/hosting/cooperative-cancellation
      Title: Cooperative cancellation
    - Url: nservicebus/hosting/critical-errors
      Title: Critical Errors
    - Url: nservicebus/lifecycle
      Title: Interface lifecycles
      Articles:
      - Url: nservicebus/lifecycle/ineedinitialization
        Title: Initialization
      - Url: nservicebus/lifecycle/iwanttorunbeforeconfigurationisfinalized
        Title: Before Configuration Finalized
      - Url: nservicebus/lifecycle/endpointstartandstop
        Title: Endpoint Instance Starts and Stops
  - Title: Upgrade Guides
    Articles:
    - Title: Azure Functions (Isolated Worker) with Service Bus
      Articles:
      - Url: nservicebus/upgrades/azure-functions-service-bus-isolated-5to6
        Title: Version 5 to 6
      - Url: nservicebus/upgrades/azure-functions-service-bus-isolated-4to5
        Title: Version 4 to 5
      - Url: nservicebus/upgrades/azure-functions-service-bus-isolated-3to4
        Title: Version 3 to 4
      - Url: nservicebus/upgrades/azure-functions-service-bus-isolated-2to3
        Title: Version 2 to 3
      - Url: nservicebus/upgrades/azure-functions-service-bus-isolated-1to2
        Title: Version 1 to 2
    - Title: Azure Functions (in-process) with Service Bus
      Articles:
      - Url: nservicebus/upgrades/azure-functions-service-bus-in-process-isolated-worker
        Title: Migrate to Azure Functions using Isolated Workers
      - Url: nservicebus/upgrades/azure-functions-service-bus-in-process-5to6
        Title: Version 5 to 6
      - Url: nservicebus/upgrades/azure-functions-service-bus-in-process-3to4
        Title: Version 3 to 4
      - Url: nservicebus/upgrades/azure-functions-service-bus-in-process-2to3
        Title: Version 2 to 3
      - Url: nservicebus/upgrades/azure-functions-service-bus-in-process-1to2
        Title: Version 1 to 2
    - Title: AWSLambda SQS
      Articles:
      - Url: nservicebus/upgrades/sqs-lambda-2to3
        Title: AwsLambda SQS 2 to 3
      - Url: nservicebus/upgrades/sqs-lambda-1to2
        Title: AwsLambda SQS 1 to 2
    - Title: NServiceBus Host
      Articles:
      - Url: nservicebus/upgrades/host-7to8
        Title: Version 7 to 8
      - Url: nservicebus/upgrades/host-6to7
        Title: Version 6 to 7
      - Url: nservicebus/upgrades/host-4to5
        Title: Version 4 to 5
    - Title: NServiceBus.Azure deprecated
      Url: nservicebus/upgrades/azure-deprecation
    - Title: Azure Cloud Services Host
      Articles:
      - Url: nservicebus/upgrades/acs-host-7to8
        Title: Version 7 to 8
      - Url: nservicebus/upgrades/acs-host-6to7
        Title: Version 6 to 7

  - Title: Standard Hosting
    Articles:
    - Url: nservicebus/hosting/extensions-hosting
      Title: Microsoft Generic Host
    - Url: nservicebus/hosting/web-application
      Title: Web Applications
      Articles:
      - Url: nservicebus/hosting/asp-net
        Title: ASP.NET
      - Url: nservicebus/hosting/publishing-from-web-applications
        Title: Publishing from Web Applications
    - Url: nservicebus/hosting/docker-host
      Title: Docker Container Host
    - Url: nservicebus/hosting/windows-service
      Title: Windows Service Installation
  - Title: Azure Functions
    Articles:
    # For the new multi-endpoint NServiceBus.AzureFunctions
    #- Url: nservicebus/hosting/azure/functions
    #  Title: Multi-Endpoint Functions Hosting
    - Url: nservicebus/hosting/azure-functions-service-bus
      Title: Isolated Worker, Single-Endpoint Model
      Articles:
      - Url: nservicebus/hosting/azure-functions-service-bus/custom-triggers
        Title: Custom triggers
      - Url: nservicebus/hosting/azure-functions-service-bus/analyzers
        Title: Roslyn analyzers
    - Url: nservicebus/hosting/azure-functions-service-bus/in-process
      Title: In-Process hosting (Deprecated)
      Articles:
      - Url: nservicebus/hosting/azure-functions-service-bus/in-process/custom-triggers
        Title: Custom triggers
      - Url: nservicebus/hosting/azure-functions-service-bus/in-process/analyzers
        Title: Roslyn analyzers
  - Title: AWS Lambda
    Articles:
      - Url: nservicebus/hosting/aws-lambda-simple-queue-service
        Title: AWS Lambda with SQS
      - Url: nservicebus/hosting/aws-lambda-simple-queue-service/analyzers
        Title: Roslyn analyzers
  - Title: Deprecated Hosting Options
    Articles:
    - Title: NServiceBus Host App
      Articles:
      - Url: nservicebus/hosting/nservicebus-host
        Title: Overview
      - Url: nservicebus/hosting/nservicebus-host/installation
        Title: Installation
      - Url: nservicebus/hosting/nservicebus-host/profiles
        Title: Profiles
      - Url: nservicebus/hosting/nservicebus-host/profiles-customization
        Title: Profiles customization
      - Url: nservicebus/hosting/nservicebus-host/logging-configuration
        Title: Logging configuration
      - Url: nservicebus/hosting/nservicebus-host/troubleshooting
        Title: Troubleshooting
    - Url: nservicebus/wcf
      Title: Exposing endpoints via WCF

- Name: ServiceInsight
  Topics:
  - Title: Introduction
    Articles:
    - Url: serviceinsight
      Title: About ServiceInsight
    - Url: serviceinsight/installation
      Title: Installation
    - Url: serviceinsight/license
      Title: Licensing
    - Url: serviceinsight/support-policy
      Title: Support Policy
  - Title: Usage
    Articles:
    - Url: serviceinsight/application-invocation
      Title: Application Invocation
    - Url: serviceinsight/managing-errors-and-retries
      Title: Managing Errors and Retries
    - Url: serviceinsight/sequence-diagram
      Title: Sequence Diagram
    - Url: serviceinsight/custom-message-viewers
      Title: Custom Message Viewers
    - Url: serviceinsight/no-data-available
      Title: Data not available
    - Url: serviceinsight/logging
      Title: Logging
    - Url: serviceinsight/troubleshooting
      Title: Troubleshooting

- Name: ServicePulse
  Topics:
    - Title: Introduction
      Articles:
        - Url: servicepulse
          Title: About ServicePulse
        - Url: servicepulse/installation
          Title: Installation
        - Url: servicepulse/containerization
          Title: Container deployment
        - Url: servicepulse/support-policy
          Title: Support Policy
    - Title: Upgrade Guides
      Articles:
      - Title: ServiceInsight to ServicePulse
        Url: servicepulse/migrate-from-serviceinsight
      - Title: Version 1 to 2
        Url: servicepulse/1to2
    - Title: Security
      Articles:
      - Title: Overview
        Url: servicepulse/security
      - Title: Configuration
        Articles:
        - Title: Authentication
          Url: servicepulse/security/configuration/authentication
        - Title: Forward Headers for Reverse Proxy
          Url: servicepulse/security/configuration/forward-headers
        - Title: TLS
          Url: servicepulse/security/configuration/tls
      - Title: Hosting guide
        Url: servicepulse/security/hosting-guide
    - Title: Configuration
      Articles:
        - Url: servicepulse/host-config
          Title: Hosting
        - Url: servicepulse/how-to-configure-endpoints-for-monitoring
          Title: Monitoring endpoints
        - Url: servicepulse/usage-config
          Title: Usage Setup
        - Url: servicepulse/install-servicepulse-in-iis
          Title: Install in IIS
        - Url: servicepulse/troubleshooting
          Title: Troubleshooting
    - Title: Features
      Articles:
        - Url: servicepulse/all-messages
          Title: All Messages
        - Url: servicepulse/intro-failed-messages
          Title: Failed Messages
        - Url: servicepulse/message-details
          Title: Message Details
        - Url: servicepulse/flow-diagram
          Title: Flow Diagram
        - Url: servicepulse/sequence-diagram
          Title: Sequence Diagram
        - Url: servicepulse/saga-diagram
          Title: Saga Diagram
        - Url: servicepulse/intro-failed-message-retries
          Title: Retrying Failed Messages
        - Url: servicepulse/intro-editing-messages
          Title: Fixing malformed messages
        - Url: servicepulse/intro-archived-messages
          Title: Deleted Messages
        - Url: servicepulse/intro-pending-retries
          Title: Pending Retries
        - Url: servicepulse/redirect
          Title: Redirects
        - Url: servicepulse/event-types
          Title: Events
        - Url: servicepulse/health-check-notifications
          Title: Health check notifications
        - Url: servicepulse/endpoint-connection
          Title: Endpoint connection settings
        - Url: servicepulse/usage
          Title: Measuring system usage

- Name: ServiceControl
  Topics:
  - Title: Introduction
    Articles:
    - Title: About ServiceControl
      Url: servicecontrol
    - Title: How does it work
      Url: servicecontrol/how
    - Title: Licensing
      Url: servicecontrol/license
    - Title: Hosting
      Url: servicecontrol/hosting
    - Title: Support policy
      Url: servicecontrol/upgrades/support-policy
    - Title: Supported versions
      Url: servicecontrol/upgrades/supported-versions
  - Title: Upgrade Guides
    Articles:
    - Title: Upgrade tips
      Url: servicecontrol/upgrades
    - Title: Version 6.4 to 6.5
      Url: servicecontrol/upgrades/6.4to6.5
    - Title: Version 6.3 to 6.4
      Url: servicecontrol/upgrades/6.3to6.4
    - Title: Version 5 to 6
      Url: servicecontrol/upgrades/5to6
    - Title: Version 5.1 to 5.2
      Url: servicecontrol/upgrades/5.1to5.2
    - Title: Version 4 to 5
      Url: servicecontrol/upgrades/4to5
    - Title: Version 3 to 4
      Url: servicecontrol/upgrades/3to4
    - Title: Version 2 to 3
      Url: servicecontrol/upgrades/2to3
    - Title: Version 1 to 2
      Url: servicecontrol/upgrades/1to2
  - Title: Security
    Articles:
    - Title: Overview
      Url: servicecontrol/security
    - Title: Configuration
      Articles:
      - Title: Authentication
        Url: servicecontrol/security/configuration/authentication
      - Title: Forward Headers for Reverse Proxy
        Url: servicecontrol/security/configuration/forward-headers
      - Title: TLS
        Url: servicecontrol/security/configuration/tls
      - Title: CORS
        Url: servicecontrol/security/configuration/cors
    - Title: Hosting guide
      Url: servicecontrol/security/hosting-guide
    - Title: Examples
      Articles:
      - Title: Microsoft Entra ID Authentication Guide
        Url: servicecontrol/security/entra-id-authentication
  - Title: Planning
    Articles:
    - Title: Optimizing for use in different environments
      Url: servicecontrol/servicecontrol-in-practice
    - Title: Hardware Considerations
      Url: servicecontrol/servicecontrol-instances/hardware
    - Title: Capacity planning
      Url: servicecontrol/capacity-and-planning
    - Title: Security
      Url: servicecontrol/securing-servicecontrol
    - Title: Non-Privileged accounts
      Url: servicecontrol/configure-non-privileged-service-account
    - Title: Business continuity / disaster recovery
      Url: servicecontrol/bcdr
    - Title: Advanced installations
      Articles:
      - Title: Cluster deployment
        Url: servicecontrol/deploying-servicecontrol-in-a-cluster
      - Title: Remote instances
        Url: servicecontrol/servicecontrol-instances/remotes
  - Title: Error instances
    Articles:
    - Title: ServiceControl Error instances
      Url: servicecontrol/servicecontrol-instances
    - Title: Integrated ServicePulse
      Url: servicecontrol/servicecontrol-instances/integrated-servicepulse
    - Title: Deployment
      Url: servicecontrol/servicecontrol-instances/deployment
      Articles:
      - Title: Using Containers
        Url: servicecontrol/servicecontrol-instances/deployment/containers
      - Title: Using PowerShell
        Url: servicecontrol/servicecontrol-instances/deployment/powershell
      - Title: Using ServiceControl Management Utility
        Url: servicecontrol/servicecontrol-instances/deployment/scmu
      - Title: Queues
        Url: servicecontrol/queues
    - Title: Configuration
      Articles:
      - Title: Settings
        Url: servicecontrol/servicecontrol-instances/configuration
      - Title: Transport configuration
        Url: servicecontrol/transports
      - Title: Configure the URI
        Url: servicecontrol/setting-custom-hostname
      - Title: RavenDB location
        Url: servicecontrol/configure-ravendb-location
      - Title: Logging
        Url: servicecontrol/logging
      - Title: Forwarding queues
        Url: servicecontrol/errorlog-auditlog-behavior
  - Title: Audit instances
    Articles:
      - Title: ServiceControl Audit instances
        Url: servicecontrol/audit-instances
      - Title: Deployment
        Url: servicecontrol/audit-instances/deployment
        Articles:
        - Title: Using Containers
          Url: servicecontrol/audit-instances/deployment/containers
        - Title: Using PowerShell
          Url: servicecontrol/audit-instances/deployment/powershell
        - Title: Using ServiceControl Management Utility
          Url: servicecontrol/audit-instances/deployment/scmu
        - Title: Queues
          Url: servicecontrol/queues
      - Title: Configuration
        Articles:
        - Title: Settings
          Url: servicecontrol/audit-instances/configuration
        - Title: Transport configuration
          Url: servicecontrol/transports
        - Title: Configure the URI
          Url: servicecontrol/setting-custom-hostname
        - Title: RavenDB location
          Url: servicecontrol/configure-ravendb-location
        - Title: Logging
          Url: servicecontrol/logging
        - Title: Forwarding queues
          Url: servicecontrol/errorlog-auditlog-behavior
  - Title: Monitoring instances
    Articles:
      - Title: ServiceControl monitoring instances
        Url: servicecontrol/monitoring-instances
      - Title: Deployment
        Url: servicecontrol/monitoring-instances/deployment
        Articles:
        - Title: Using Containers
          Url: servicecontrol/monitoring-instances/deployment/containers
        - Title: Using PowerShell
          Url: servicecontrol/monitoring-instances/deployment/powershell
        - Title: Using ServiceControl Management Utility
          Url: servicecontrol/monitoring-instances/deployment/scmu
        - Title: Queues
          Url: servicecontrol/queues
      - Title: Configuration
        Articles:
        - Title: Settings
          Url: servicecontrol/monitoring-instances/configuration
        - Title: Transport configuration
          Url: servicecontrol/transports
        - Title: Configure the URI
          Url: servicecontrol/monitoring-instances/configure-the-uri
  - Title: Data Management
    Articles:
    - Title: Data expiration
      Url: servicecontrol/how-purge-expired-data
    - Title: Accessing ServiceControl database
      Url: servicecontrol/ravendb/accessing-database
    - Title: Backup
      Url: servicecontrol/backup-sc-database
    - Title: Containers
      Url: servicecontrol/ravendb/containers
    - Title: Compacting the database
      Url: servicecontrol/db-compaction
    - Title: Move database location
      Url: servicecontrol/move-database-location
  - Title: Integration
    Articles:
    - Title: Integration events
      Url: servicecontrol/contracts
    - Title: Transport adapter
      Url: servicecontrol/transport-adapter
  - Title: MassTransit
    Articles:
    - Title: Introduction
      Url: servicecontrol/masstransit
    - Title: Deployment
      Url: servicecontrol/masstransit/docker-deployment
  - Title: Migrations
    Articles:
    - Title: Overview
      Url: servicecontrol/migrations
    - Title: Windows hosting to Containers
      Url: servicecontrol/migrations/windows-to-containers
    - Title: Retaining data between instances
      Url: servicecontrol/migrations/retain-data-between-instances
    - Title: Replacing Error instances
      Url: servicecontrol/migrations/replacing-error-instances
      Articles:
      - Title: using ServiceControl Management
        Url: servicecontrol/migrations/replacing-error-instances/scmu
      - Title: using PowerShell
        Url: servicecontrol/migrations/replacing-error-instances/powershell
      - Title: using Containers
        Url: servicecontrol/migrations/replacing-error-instances/containers
    - Title: Replacing Audit instances
      Url: servicecontrol/migrations/replacing-audit-instances
      Articles:
      - Title: using ServiceControl Management
        Url: servicecontrol/migrations/replacing-audit-instances/scmu
      - Title: using PowerShell
        Url: servicecontrol/migrations/replacing-audit-instances/powershell
      - Title: using Containers
        Url: servicecontrol/migrations/replacing-audit-instances/containers
    - Title: New persistence format
      Url: servicecontrol/migrations/new-persistence
  - Title: Troubleshooting
    Articles:
    - Title: ServiceControl troubleshooting
      Url: servicecontrol/troubleshooting
    - Title: Retry importing messages
      Url: servicecontrol/import-failed-messages
    - Title: Sequence contains no matching element
      Url: servicecontrol/sequence-contains-no-matching-element
- Name: Monitoring
  Topics:
  - Title: Intro to Monitoring
    Url: monitoring
  - Title: Heartbeats
    Articles:
    - Title: Introduction to heartbeats
      Url: monitoring/heartbeats
    - Title: Install plugin
      Url: monitoring/heartbeats/install-plugin
    - Title: Managing in ServicePulse
      Url: monitoring/heartbeats/in-servicepulse
    - Title: Notification events
      Url: monitoring/heartbeats/notification-events
  - Title: Custom checks
    Articles:
    - Title: Introduction to custom checks
      Url: monitoring/custom-checks
    - Title: Install plugin
      Url: monitoring/custom-checks/install-plugin
    - Title: Writing Custom Checks
      Url: monitoring/custom-checks/writing-custom-checks
    - Title: Managing in ServicePulse
      Url: monitoring/custom-checks/in-servicepulse
    - Title: Notification events
      Url: monitoring/custom-checks/notification-events
  - Title: Performance Metrics
    Articles:
    - Title: Introduction to performance metrics
      Url: monitoring/metrics
    - Title: Metrics captured
      Url: monitoring/metrics/definitions
    - Title: Install plugin
      Url: monitoring/metrics/install-plugin
    - Title: Managing in ServicePulse
      Url: monitoring/metrics/in-servicepulse
    - Title: Accessing raw metric data
      Url: monitoring/metrics/raw
    - Title: Windows Performance Counters
      Url: monitoring/metrics/performance-counters
  - Title: Upgrade guides
    Articles:
    - Title: Upgrading to native queue length metric
      Url: monitoring/upgrade-guides/native-queue-length

- Name: Modernization
  Topics:
  - Title: Introduction
    Url: modernization
  - Title: Migrate to the Cloud
    Articles:
    - Title: Overview
      Url: modernization/migrate-to-the-cloud
      Articles:
      - Title: On-premises to AWS
        Url: modernization/migrate-to-the-cloud/on-premises-to-aws
      - Title: On-premises to Azure
        Url: modernization/migrate-to-the-cloud/on-premises-to-azure

- Name: Shape the future
  Topics:
  - Title: Introduction
    Url: shape-the-future
  - Title: NServiceBus and CloudEvents
    Url: shape-the-future/cloudevents
  - Title: NServiceBus and Apache Avro
    Url: shape-the-future/avro
  - Title: NServiceBus and .NET Aspire
    Url: shape-the-future/aspire
  - Title: NServiceBus and Redis
    Url: shape-the-future/redis
  - Title: NServiceBus and Infrastructure as Code (IaC)
    Url: shape-the-future/iac-provisioning
  - Title: NServiceBus and AsyncAPI
    Url: shape-the-future/asyncapi