Improve structure of the asb tool docs (#6996)

Author: SzymonPobiega

nservicebus/hosting/azure-functions-service-bus/in-process/index.md

@@ -78,7 +78,7 @@ Use the [`asb-transport` command line (CLI) tool](/transports/azure-service-bus/
 asb-transport endpoint create <queue name>
 ```
 
-See the [full documentation](/transports/azure-service-bus/operational-scripting.md#operational-scripting-asb-transport-endpoint-create) for the `asb-transport endpoint create` command for more details.
+See the [full documentation](/transports/azure-service-bus/operational-scripting.md#available-commands-asb-transport-endpoint-create) for the `asb-transport endpoint create` command for more details.
 
 > [!WARNING]
 > If the `asb-tranport` command-line tool is not used to create the queue, it is recommended to set the `MaxDeliveryCount` setting to the maximum value.
@@ -89,7 +89,7 @@ See the [full documentation](/transports/azure-service-bus/operational-scripting
 asb-transport endpoint subscribe <queue name> <eventtype>
 ```
 
-See the [full documentation](/transports/azure-service-bus/operational-scripting.md#operational-scripting-asb-transport-endpoint-subscribe) for the `asb-transport endpoint subscribe` command for more details.
+See the [full documentation](/transports/azure-service-bus/operational-scripting.md#available-commands-asb-transport-endpoint-subscribe) for the `asb-transport endpoint subscribe` command for more details.
 
 partial: assembly-scanner
 

nservicebus/hosting/azure-functions-service-bus/index.md

@@ -66,7 +66,7 @@ To manually provision the entities in the namespace for the Function endpoint, u
 asb-transport endpoint create <queue name>
 ```
 
-For more details, see the [operation scripting documentation](/transports/azure-service-bus/operational-scripting.md#operational-scripting-asb-transport-endpoint-create) for the `asb-transport endpoint create` command.
+For more details, see the [operation scripting documentation](/transports/azure-service-bus/operational-scripting.md#available-commands-asb-transport-endpoint-create) for the `asb-transport endpoint create` command.
 
 > [!WARNING]
 > If the `asb-transport` command-line tool is not used to create the queue, set the `MaxDeliveryCount` setting to the maximum value.
@@ -77,6 +77,6 @@ For more details, see the [operation scripting documentation](/transports/azure-
 asb-transport endpoint subscribe <queue name> <eventtype>
 ```
 
-For more details, see the [operational scripting documentation](/transports/azure-service-bus/operational-scripting.md#operational-scripting-asb-transport-endpoint-subscribe) for the `asb-transport endpoint subscribe` command.
+For more details, see the [operational scripting documentation](/transports/azure-service-bus/operational-scripting.md#available-commands-asb-transport-endpoint-subscribe) for the `asb-transport endpoint subscribe` command.
 
 partial: package-requirements

servicecontrol/queues.md

@@ -9,7 +9,7 @@ ServiceControl relies on a number of queues to function. The simplest way to con
 
 These queues can be manually created before deploying a ServiceControl instance. The technique used will differ depending on the transport in use:
 
-- [Azure Service Bus](/transports/azure-service-bus/operational-scripting.md#operational-scripting-asb-transport-queue-create)
+- [Azure Service Bus](/transports/azure-service-bus/operational-scripting.md#available-commands-asb-transport-queue-create)
 - [Azure Storage Queues](/transports/azure-storage-queues/operations-scripting.md#create-queues)
 - [SQL Server](/transports/sql/operations-scripting.md#create-queues)
 - [MSMQ](/transports/msmq/operations-scripting.md#create-queues)

transports/azure-service-bus/operational-scripting.md

@@ -19,6 +19,14 @@ Once installed, the `asb-transport` command line tool will be available for use.
 
 `asb-transport <command> [options]`
 
+## Available commands
+
+- `endpoint create`
+- `endpoint subscribe`
+- `endpoint unsubscribe`
+- `queue create`
+- `queue delete`
+
 partial: endpoint-command
 
 ### asb-transport queue create
@@ -56,22 +64,24 @@ asb-transport queue delete name
 
 `-n` | `--namespace` : Sets the fully qualified namespace to connect with cached credentials, e.g., credentials from Azure PowerShell or CLI. This setting cannot be used in conjunction with the connection string setting.
 
-### Examples
+partial: migration-endpoint-command
+
+## Examples
 
-#### Provisioning the audit and the error queues
+### Provisioning the audit and the error queues
 
 ```
 asb-transport queue create audit -c "<connection-string>"
 asb-transport queue create error -c "<connection-string>"
 ```
 
-#### Using connection strings
+### Using connection strings
 
 ```
 asb-transport [command] [subcommand] -c "<connection-string>"
 ```
 
-#### Using cached credentials
+### Using cached credentials
 
 ```
 asb-transport [command] [subcommand] -n "somenamespace.servicebus.windows.net"

transports/azure-service-bus/operational-scripting_endpoint-command_asbs_[,5).partial.md

@@ -1,14 +1,6 @@
-### Available commands
-
-- `endpoint create`
-- `endpoint subscribe`
-- `endpoint unsubscribe`
-- `queue create`
-- `queue delete`
-
 ### asb-transport endpoint create
 
-Create a new endpoint using:
+Creates infrastructure for an endpoint: input queue, topic, and subscription.
 
 ```
 asb-transport endpoint create name
@@ -39,7 +31,7 @@ asb-transport endpoint create name
 
 ### asb-transport endpoint subscribe
 
-Create a new subscription for an endpoint using:
+Creates a new subscription for an endpoint.
 
 ```
 asb-transport endpoint subscribe name event-type
@@ -62,7 +54,7 @@ asb-transport endpoint subscribe name event-type
 
 ### asb-transport endpoint unsubscribe
 
-Delete a subscription for an endpoint using:
+Deletes a subscription for an endpoint.
 
 ```
 asb-transport endpoint unsubscribe name event-type

transports/azure-service-bus/operational-scripting_endpoint-command_asbs_[5,).partial.md

@@ -1,19 +1,6 @@
-### Available commands
-
-- `endpoint create`
-- `endpoint subscribe`
-- `endpoint unsubscribe`
-- `migration endpoint create`
-- `migration endpoint subscribe`
-- `migration endpoint unsubscribe`
-- `migration endpoint subscribe migrated`
-- `migration endpoint unsubscribe migrated`
-- `queue create`
-- `queue delete`
-
 ### asb-transport endpoint create
 
-Create a new endpoint using:
+Creates infrastructure for an endpoint -- input queue.
 
 ```
 asb-transport endpoint create name
@@ -33,7 +20,7 @@ asb-transport endpoint create name
 
 ### asb-transport endpoint subscribe
 
-Create a new subscription for an endpoint using:
+Creates a new subscription for an endpoint.
 
 ```
 asb-transport endpoint subscribe name topic
@@ -50,7 +37,7 @@ asb-transport endpoint subscribe name topic
 
 ### asb-transport endpoint unsubscribe
 
-Delete a subscription for an endpoint using:
+Deletes a subscription for an endpoint.
 
 ```
 asb-transport endpoint unsubscribe name topic
@@ -64,114 +51,3 @@ asb-transport endpoint unsubscribe name topic
 `-n` | `--namespace` : Sets the fully qualified namespace to connect with cached credentials, e.g., credentials from Azure PowerShell or CLI. This setting cannot be used in conjunction with the connection string setting.
 
 `-b` | `--subscription`: Subscription name (defaults to endpoint name)
-
-### asb-transport migration endpoint create
-
-Create a new endpoint that uses migration topology using:
-
-```
-asb-transport migration endpoint create name
-                              [--size]
-                              [--partitioned]
-                              [--topic]
-                              [--topic-to-publish-to] [--topic-to-subscribe-on]
-                              [--subscription]
-```
-
-#### options
-
-`-c` | `--connection-string` : Overrides the environment variable 'AzureServiceBus_ConnectionString'
-
-`-n` | `--namespace` : Sets the fully qualified namespace to connect with cached credentials, e.g., credentials from Azure PowerShell or CLI. This setting cannot be used in conjunction with the connection string setting.
-
-`-s` | `--size` : Queue size in GB (defaults to 5)
-
-`-p` | `--partitioned`: Enable partitioning
-
-`-t` | `--topic`: Topic name (defaults to 'bundle-1')
-
-`-tp` | `--topic-to-publish-to`: The topic name to publish to.
-
-`-ts` | `--topic-to-subscribe-on`: The topic name to subscribe on.
-
-`-b` | `--subscription`: Subscription name (defaults to endpoint name)
-
-### asb-transport migration endpoint subscribe
-
-Create a new subscription for an endpoint that uses migration topology using:
-
-```
-asb-transport migration endpoint subscribe name event-type
-                              [--topic]
-                              [--subscription]
-                              [--rule-name]
-```
-
-#### Options
-
-`-c` | `--connection-string` : Overrides the environment variable 'AzureServiceBus_ConnectionString'
-
-`-n` | `--namespace` : Sets the fully qualified namespace to connect with cached credentials, e.g., credentials from Azure PowerShell or CLI. This setting cannot be used in conjunction with the connection string setting.
-
-`-t` | `--topic`: Topic name to subscribe on (defaults to 'bundle-1')
-
-`-b` | `--subscription`: Subscription name (defaults to endpoint name)
-
-`-r` | `--rule-name`: Rule name (defaults to event type)
-
-### asb-transport migration endpoint unsubscribe
-
-Delete a subscription for an endpoint that uses migration topology using:
-
-```
-asb-transport migration endpoint unsubscribe name event-type
-                              [--topic]
-                              [--subscription]
-                              [--rule-name]
-```
-
-#### Options
-
-`-c` | `--connection-string` : Overrides the environment variable 'AzureServiceBus_ConnectionString'
-
-`-n` | `--namespace` : Sets the fully qualified namespace to connect with cached credentials, e.g., credentials from Azure PowerShell or CLI. This setting cannot be used in conjunction with the connection string setting.
-
-`-t` | `--topic`: Topic name to unsubscribe from (defaults to 'bundle-1')
-
-`-b` | `--subscription`: Subscription name (defaults to endpoint name)
-
-`-r` | `--rule-name`: Rule name (defaults to event type)
-
-### asb-transport migration endpoint subscribe-migrated
-
-Create a new subscription for an endpoint that uses migration topology using:
-
-```
-asb-transport migration endpoint subscribe-migrated name topic
-                              [--subscription]
-```
-
-#### Options
-
-`-c` | `--connection-string` : Overrides the environment variable 'AzureServiceBus_ConnectionString'
-
-`-n` | `--namespace` : Sets the fully qualified namespace to connect with cached credentials, e.g., credentials from Azure PowerShell or CLI. This setting cannot be used in conjunction with the connection string setting.
-
-`-b` | `--subscription`: Subscription name (defaults to endpoint name)
-
-### asb-transport migration endpoint unsubscribe-migrated
-
-Delete a subscription for an endpoint that uses migration topology using:
-
-```
-asb-transport migration endpoint unsubscribe-migrated name topic
-                              [--subscription]
-```
-
-#### Options
-
-`-c` | `--connection-string` : Overrides the environment variable 'AzureServiceBus_ConnectionString'
-
-`-n` | `--namespace` : Sets the fully qualified namespace to connect with cached credentials, e.g., credentials from Azure PowerShell or CLI. This setting cannot be used in conjunction with the connection string setting.
-
-`-b` | `--subscription`: Subscription name (defaults to endpoint name)

transports/azure-service-bus/operational-scripting_examples_asbs_[,5).partial.md

@@ -1,4 +1,4 @@
-#### Provisioning endpoints
+### Provisioning endpoints
 
 Create the topology for an endpoint named `MyEndpoint` using the default settings:
 
@@ -18,7 +18,7 @@ Create the topology for an endpoint named `MyEndpoint` and override the publish
 asb-transport endpoint create MyEndpoint -tp custom-publish-topic -ts custom-subscribe-topic -c "<connection-string>"
 ```
 
-#### Subscribing to events
+### Subscribing to events
 
 Subscribe `MyOtherEndpoint` to the event `Contracts.Events.SomeEvent` using the default settings:
 

transports/azure-service-bus/operational-scripting_examples_asbs_[5,).partial.md

@@ -1,12 +1,12 @@
-#### Provisioning endpoints
+### Provisioning endpoints
 
 Create the topology for an endpoint named `MyEndpoint`:
 
 ```
 asb-transport endpoint create MyEndpoint -c "<connection-string>"
 ```
 
-#### Subscribing to events
+### Subscribing to events
 
 Subscribe `MyOtherEndpoint` to the event `Contracts.Events.SomeEvent` using the default settings:
 
@@ -20,7 +20,7 @@ Subscribe `MyOtherEndpoint` to the event `Contracts.Events.SomeEvent` and overri
 asb-transport endpoint subscribe MyOtherEndpoint Contracts.Events.SomeEvent -s my-other-endpoint -c "<connection-string>"
 ```
 
-#### Provisioning endpoints that use migration topology
+### Provisioning endpoints that use migration topology
 
 Create the topology for an endpoint named `MyEndpoint` using the default settings:
 
@@ -40,7 +40,7 @@ Create the topology for an endpoint named `MyEndpoint` and override the publish
 asb-transport migration endpoint create MyEndpoint -tp custom-publish-topic -ts custom-subscribe-topic -c "<connection-string>"
 ```
 
-#### Subscribing to events
+### Subscribing to events
 
 Subscribe `MyOtherEndpoint` to the event `Contracts.Events.SomeEvent` using the default settings: