chore: update docs to include websockets info (#1076)

chore: update docs to include websockets info (#1076)

Author: saralab

docs/openapi.yaml

@@ -237,7 +237,7 @@ paths:
       description: |
           Retrieves all transactions that have been recently broadcast to the mempool. These are pending transactions awaiting confirmation.
 
-          If you need to monitor new transactions, we highly recommend subscribing  to [WebSockets or Socket.io](https://github.com/hirosystems/stacks-blockchain-api/tree/master/client) for real-time updates.
+          If you need to monitor new transactions, we highly recommend subscribing to [WebSockets or Socket.io](https://github.com/hirosystems/stacks-blockchain-api/tree/master/client) for real-time updates.
       parameters:
         - name: sender_address
           in: query
@@ -490,7 +490,10 @@ paths:
       tags:
         - Microblocks
       operationId: get_microblock_list
-      description: Retrieves a list of microblocks.
+      description: |
+          Retrieves a list of microblocks.
+
+          If you need to actively monitor new microblocks, we highly recommend subscribing to [WebSockets or Socket.io](https://github.com/hirosystems/stacks-blockchain-api/tree/master/client) for real-time updates.
       parameters:
         - name: limit
           in: query
@@ -560,7 +563,10 @@ paths:
   /extended/v1/block:
     get:
       summary: Get recent blocks
-      description: Retrieves a list of recently mined blocks
+      description: |
+          Retrieves a list of recently mined blocks
+
+          If you need to actively monitor new blocks, we highly recommend subscribing to [WebSockets or Socket.io](https://github.com/hirosystems/stacks-blockchain-api/tree/master/client) for real-time updates.
       tags:
         - Blocks
       operationId: get_block_list
@@ -1250,7 +1256,10 @@ paths:
   /extended/v1/address/{principal}/transactions:
     get:
       summary: Get account transactions
-      description: Retrieves a list of all Transactions for a given Address or Contract Identifier. More information on Transaction types can be found [here](https://docs.stacks.co/understand-stacks/transactions#types).
+      description: |
+          Retrieves a list of all Transactions for a given Address or Contract Identifier. More information on Transaction types can be found [here](https://docs.stacks.co/understand-stacks/transactions#types).
+
+          If you need to actively monitor new transactions for an address or contract id, we highly recommend subscribing to [WebSockets or Socket.io](https://github.com/hirosystems/stacks-blockchain-api/tree/master/client) for real-time updates.
       tags:
         - Accounts
       operationId: get_account_transactions