Skip to content

Commit 91d4efe

Browse files
authored
Fix grammar and clarity in selecting.md
Corrected minor grammatical errors and improved clarity in the documentation regarding cloud-hosted queueing technologies and their characteristics.
1 parent 4b7039f commit 91d4efe

File tree

1 file changed

+10
-10
lines changed

1 file changed

+10
-10
lines changed

transports/selecting.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ Each of the following sections describes the advantages and disadvantages of eac
2929
* [MSMQ](#msmq)
3030
* [Learning Transport](#learning)
3131

32-
For transports that use a cloud-hosted queueing technology, the quality of the network connection between the applications and the cloud provider is important. If the connection is problematic, it may not be possible to send messages. For example, this may result in problems capturing data from a user interface. If applications are running in the same data centre as the queueing technology, this risk is mitigated.
32+
For transports that use a cloud-hosted queueing technology, the quality of the network connection between the applications and the cloud provider is important. If the connection is problematic, it may not be possible to send messages. For example, this may result in problems capturing data from a user interface. If applications are running in the same data center as the queueing technology, this risk is mitigated.
3333

3434
This is a basic flowchart for selecting a supported transport. Where more than one transport is listed, refer to the sections below. They describe the advantages and disadvantages of each transport in more detail.
3535

@@ -55,7 +55,7 @@ NNN-->|No|NNNN[<center>RabbitMQ/<br/>SQL Server</center>]
5555

5656
The learning transport should not be used in production.
5757

58-
This transport is intended to learn how to work with NServiceBus. It does not require installing queueing technology and works "out of the box". This is done by storing sent and received messages as files on disk.
58+
This transport is intended for learning how to work with NServiceBus. It does not require installing queueing technology and works "out of the box". This is done by storing sent and received messages as files on disk.
5959

6060
## Azure Service Bus
6161

@@ -66,15 +66,15 @@ Azure provides multiple messaging technologies. One of the most advanced and rel
6666
- Fully managed, turn-key infrastructure
6767
- Ease of scaling
6868
- Ease of feature selection
69-
- Supports message transactions. Other Azure queueing technologies do not
70-
- Up to 100MB message size on the Premium tier. See [Large messages support](https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-premium-messaging#large-messages-support) for more information
71-
- More native capabilities, such as delayed message delivery, which requires an [outbox](/nservicebus/outbox) when using some other transports
72-
- Local development experience using the [Azure Service Bus Emulator](https://learn.microsoft.com/en-us/azure/service-bus-messaging/overview-emulator)
69+
- Supports message transactions (other Azure queueing technologies do not)
70+
- Up to 100MB message size on the Premium tier (see [Large messages support](https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-premium-messaging#large-messages-support) for more information)
71+
- More native capabilities (including delayed message delivery, which requires an [outbox](/nservicebus/outbox) when using some other transports)
72+
- Local development supported using the [Azure Service Bus Emulator](https://learn.microsoft.com/en-us/azure/service-bus-messaging/overview-emulator)
7373

7474
### Disadvantages
7575

76-
- Requires careful monitoring of costs, although the transport does provide features for throttling throughput
77-
- Atomic message receive, and data manipulation requires an [outbox](/nservicebus/outbox).
76+
- Requires careful monitoring of costs (although the transport does provide features for throttling throughput)
77+
- Atomic message receive and data manipulation requires an [outbox](/nservicebus/outbox)
7878
- Message processing time is limited to 5 minutes
7979
- Relies on TCP, which may require opening additional ports in a firewall
8080

@@ -99,15 +99,15 @@ Azure Storage Queues has fewer features than Azure Service Bus, but can be more
9999
### Disadvantages
100100

101101
- The size of a single message is limited to 64 KB, including headers and body. NServiceBus uses headers for metadata, which could consume a lot of the message's overall size.
102-
- Atomic message receive, and data manipulation requires an [outbox](/nservicebus/outbox).
102+
- Atomic message receive and data manipulation requires an [outbox](/nservicebus/outbox).
103103
- Does not offer a native publish-subscribe mechanism. A database is required for storing event subscriptions (via [NServiceBus persistence](/persistence)). [Explicit routing for publish/subscribe](/nservicebus/messaging/routing.md#event-routing-message-driven) must also be specified.
104104
- Significant latency when receiving messages, due to polling over HTTP for new messages.
105105

106106
### When to select this transport
107107

108108
- When the application is running on Microsoft Azure, and the additional features of Azure Service Bus are not worth the cost
109109
- When high throughput is not required
110-
- When scale-out is not required. Scaling out requires Azure Service Bus
110+
- When scale-out is not required (scaling out requires Azure Service Bus)
111111

112112
## SQL Server
113113

0 commit comments

Comments
 (0)