update formatting for the tutorials section

Author: eshaben

tutorials/dapps/remark-tutorial.md

@@ -17,10 +17,10 @@ When the application detects a remark addressed to the specified account, it pla
 
 Before starting, ensure the following tools and dependencies are installed:
 
-- Node.js (version 18 or higher)
-- A package manager (npm or yarn)
+- Node.js (version 18 or higher).
+- A package manager (npm or yarn).
 - [Polkadot.js browser extension (wallet)](https://polkadot.js.org/extension/){target=\_blank}
-- An account with [Westend tokens](https://faucet.polkadot.io/westend){target=\_blank}
+- An account with [Westend tokens](https://faucet.polkadot.io/westend){target=\_blank}.
 
 ## Clone the Repository
 

tutorials/interoperability/index.md

@@ -18,8 +18,8 @@ XCM provides a secure and trustless framework that facilitates communication bet
 
 Learn to establish and use cross-chain communication channels:
 
-- **[Opening HRMP Channels Between Parachains](/tutorials/interoperability/xcm-channels/para-to-para/)** - set up uni- and bidirectional messaging channels between parachains
-- **[Opening HRMP Channels with System Parachains](/tutorials/interoperability/xcm-channels/para-to-system/)** - establish communication channels with system parachains using optimized XCM messages
+- **[Opening HRMP Channels Between Parachains](/tutorials/interoperability/xcm-channels/para-to-para/)**: Set up uni- and bidirectional messaging channels between parachains.
+- **[Opening HRMP Channels with System Parachains](/tutorials/interoperability/xcm-channels/para-to-system/)**: Establish communication channels with system parachains using optimized XCM messages.
 
 ## In This Section
 

tutorials/interoperability/xcm-channels/para-to-para.md

@@ -10,8 +10,8 @@ tutorial_badge: Advanced
 
 For establishing communication channels between parachains on the Polkadot network using the Horizontal Relay-routed Message Passing (HRMP) protocol, the following steps are required:
 
-1. **Channel request** - the parachain that wants to open an HRMP channel must make a request to the parachain it wishes to have an open channel with
-2. **Channel acceptance** - the other parachain must then accept this request to complete the channel establishment
+1. **Channel request**: The parachain that wants to open an HRMP channel must make a request to the parachain it wishes to have an open channel with.
+2. **Channel acceptance**: The other parachain must then accept this request to complete the channel establishment.
 
 This process results in a unidirectional HRMP channel, where messages can flow in only one direction between the two parachains.
 
@@ -23,8 +23,8 @@ Once both unidirectional channels are established, the parachains can send messa
 
 Before proceeding, ensure you meet the following requirements:
 
-- Blockchain network with a relay chain and at least two connected parachains
-- Wallet with sufficient funds to execute transactions on the participant chains
+- Blockchain network with a relay chain and at least two connected parachains.
+- Wallet with sufficient funds to execute transactions on the participant chains.
 
 ## Procedure to Initiate an HRMP Channel
 
@@ -42,12 +42,12 @@ Use [Polkadot.js Apps](https://polkadot.js.org/apps/#/explorer){target=\_blank}
 
     1. Determine if the parachain is an "up/down" chain (parent or child) or a "sibling" chain:
 
-        - Up/down chains use the prefix `0x70617261` (which decodes to `b"para"`)
+        - Up/down chains use the prefix `0x70617261` (which decodes to `b"para"`).
 
-        - Sibling chains use the prefix `0x7369626c` (which decodes to `b"sibl"`)
+        - Sibling chains use the prefix `0x7369626c` (which decodes to `b"sibl"`).
 
     2. Calculate the u32 scale encoded value of the parachain ID:
-        - Parachain 2500 would be encoded as `c4090000`
+        - Parachain 2500 would be encoded as `c4090000`.
 
     3. Combine the prefix and parachain ID encoding to form the full sovereign account address:
 
@@ -58,19 +58,19 @@ Use [Polkadot.js Apps](https://polkadot.js.org/apps/#/explorer){target=\_blank}
 
 ### Create Channel Opening Extrinsic
 
-1. In Polkadot.js Apps, connect to the relay chain, navigate to the **Developer** dropdown and select the **Extrinsics** option
+1. In Polkadot.js Apps, connect to the relay chain, navigate to the **Developer** dropdown and select the **Extrinsics** option.
 
     ![](/images/tutorials/interoperability/xcm-channels/para-to-para/hrmp-para-to-para-1.webp)
 
-2. Construct an `hrmpInitOpenChannel` extrinsic call
+2. Construct an `hrmpInitOpenChannel` extrinsic call.
 
-    1. Select the **`hrmp`** pallet
-    2. Choose the **`hrmpInitOpenChannel`** extrinsic
-    3. Fill in the parameters
-        - **`recipient`** - parachain ID of the target chain (in this case, 2600)
-        - **`proposedMaxCapacity`** - max number of messages that can be pending in the channel at once
-        - **`proposedMaxMessageSize`** - max message size that could be put into the channel
-    4. Copy the encoded call data
+    1. Select the **`hrmp`** pallet.
+    2. Choose the **`hrmpInitOpenChannel`** extrinsic.
+    3. Fill in the parameters:
+        - **`recipient`**: Parachain ID of the target chain (in this case, 2600).
+        - **`proposedMaxCapacity`**: Max number of messages that can be pending in the channel at once.
+        - **`proposedMaxMessageSize`**: Max message size that could be put into the channel.
+    4. Copy the encoded call data.
     ![](/images/tutorials/interoperability/xcm-channels/para-to-para/hrmp-para-to-para-2.webp)
     The encoded call data for opening a channel with parachain 2600 is `0x3c00280a00000800000000001000`.
 
@@ -82,11 +82,11 @@ This example uses the `sudo` pallet to dispatch the extrinsic. Verify the XCM co
 
 The XCM message should contain the following instructions:
 
-- **`WithdrawAsset`** - withdraws assets from the origin's ownership and places them in the Holding Register
-- **`BuyExecution`** - pays for the execution of the current message using the assets in the Holding Register
-- **`Transact`** - execute the encoded transaction call
-- **`RefundSurplus`** - increases the Refunded Weight Register to the value of the Surplus Weight Register, attempting to reclaim any excess fees paid via BuyExecution
-- **`DepositAsset`** - subtracts assets from the Holding Register and deposits equivalent on-chain assets under the specified beneficiary's ownership
+- **`WithdrawAsset`**: Withdraws assets from the origin's ownership and places them in the Holding Register.
+- **`BuyExecution`**: Pays for the execution of the current message using the assets in the Holding Register.
+- **`Transact`**: Execute the encoded transaction call.
+- **`RefundSurplus`**: Increases the Refunded Weight Register to the value of the Surplus Weight Register, attempting to reclaim any excess fees paid via BuyExecution.
+- **`DepositAsset`**: Subtracts assets from the Holding Register and deposits equivalent on-chain assets under the specified beneficiary's ownership.
 
 !!!note 
     For more detailed information about XCM's functionality, complexities, and instruction set, refer to the [xcm-format](https://github.com/polkadot-fellows/xcm-format){target=_blank} documentation.
@@ -95,9 +95,9 @@ In essence, this process withdraws funds from the parachain's sovereign account
 
 To send the XCM message to the relay chain, connect to parachain 2500 in Polkadot.js Apps. Fill in the required parameters as shown in the image below, ensuring that you:
 
-1. Replace the **`call`** field with your encoded `hrmpInitOpenChannel` call data from the previous step
-2. Use the correct beneficiary information
-3. Click the **Submit Transaction** button to dispatch the XCM message to the relay chain
+1. Replace the **`call`** field with your encoded `hrmpInitOpenChannel` call data from the previous step.
+2. Use the correct beneficiary information.
+3. Click the **Submit Transaction** button to dispatch the XCM message to the relay chain.
 
 ![](/images/tutorials/interoperability/xcm-channels/para-to-para/hrmp-para-to-para-3.webp)
 
@@ -106,15 +106,15 @@ To send the XCM message to the relay chain, connect to parachain 2500 in Polkado
 
 After submitting the XCM message to initiate the HRMP channel opening, you should verify that the request was successful. Follow these steps to check the status of your channel request:
 
-1. Using Polkadot.js Apps, connect to the relay chain and navigate to the **Developer** dropdown, then select the **Chain state** option
+1. Using Polkadot.js Apps, connect to the relay chain and navigate to the **Developer** dropdown, then select the **Chain state** option.
 
     ![](/images/tutorials/interoperability/xcm-channels/hrmp-channels-1.webp)
 
-2. Query the HRMP open channel requests
-    1. Select **`hrmp`**
-    2. Choose the **`hrmpOpenChannelRequests`** call
-    3. Click the **+** button to execute the query
-    4. Check the status of all pending channel requests
+2. Query the HRMP open channel requests.
+    1. Select **`hrmp`**.
+    2. Choose the **`hrmpOpenChannelRequests`** call.
+    3. Click the **+** button to execute the query.
+    4. Check the status of all pending channel requests.
 
     ![](/images/tutorials/interoperability/xcm-channels/para-to-para/hrmp-para-to-para-4.webp)
 
@@ -131,46 +131,46 @@ To fund the account, follow the same process described in the previous section,
 
 ### Create Channel Accepting Extrinsic
 
-1. In Polkadot.js Apps, connect to the relay chain, navigate to the **Developer** dropdown and select the **Extrinsics** option
+1. In Polkadot.js Apps, connect to the relay chain, navigate to the **Developer** dropdown and select the **Extrinsics** option.
 
     ![](/images/tutorials/interoperability/xcm-channels/para-to-para/hrmp-para-to-para-1.webp)
 
-2. Construct an `hrmpAcceptOpenChannel` extrinsic call
+2. Construct an `hrmpAcceptOpenChannel` extrinsic call:
 
-    1. Select the **`hrmp`** pallet
-    2. Choose the **`hrmpAcceptOpenChannel`** extrinsic
+    1. Select the **`hrmp`** pallet.
+    2. Choose the **`hrmpAcceptOpenChannel`** extrinsic.
     3. Fill in the parameters:
-        - **`sender`** - parachain ID of the requesting chain (in this case, 2500)
-    4. Copy the encoded call data
+        - **`sender`**: Parachain ID of the requesting chain (in this case, 2500).
+    4. Copy the encoded call data.
     ![](/images/tutorials/interoperability/xcm-channels/para-to-para/hrmp-para-to-para-5.webp)
     The encoded call data for accepting a channel with parachain 2500 should be `0x3c01c4090000`
 
 ### Craft and Submit the XCM Message from the Receiver
 
 To accept the HRMP channel opening, you need to create and submit an XCM message that includes the encoded `hrmpAcceptOpenChannel` call data from the previous step. This process is similar to the one described in the previous section, [Craft and Submit the XCM Message](#craft-and-submit-the-xcm-message-from-the-sender), with a few key differences:
 
-- Use the encoded call data for `hrmpAcceptOpenChannel` obtained in Step 2 of this section
-- In the last XCM instruction (DepositAsset), set the beneficiary to parachain 2600's sovereign account to receive any surplus funds
+- Use the encoded call data for `hrmpAcceptOpenChannel` obtained in Step 2 of this section.
+- In the last XCM instruction (DepositAsset), set the beneficiary to parachain 2600's sovereign account to receive any surplus funds.
 
 To send the XCM message to the relay chain, connect to parachain 2600 in Polkadot.js Apps. Fill in the required parameters as shown in the image below, ensuring that you:
 
-1. Replace the **`call`** field with your encoded `hrmpAcceptOpenChannel` call data from the previous step
-2. Use the correct beneficiary information
-3. Click the **Submit Transaction** button to dispatch the XCM message to the relay chain
+1. Replace the **`call`** field with your encoded `hrmpAcceptOpenChannel` call data from the previous step.
+2. Use the correct beneficiary information.
+3. Click the **Submit Transaction** button to dispatch the XCM message to the relay chain.
 
 ![](/images/tutorials/interoperability/xcm-channels/para-to-para/hrmp-para-to-para-6.webp)
 
 After submitting the XCM message to accept the HRMP channel opening, verify that the channel has been set up correctly.
 
-1. Using Polkadot.js Apps, connect to the relay chain and navigate to the **Developer** dropdown, then select the **Chain state** option
+1. Using Polkadot.js Apps, connect to the relay chain and navigate to the **Developer** dropdown, then select the **Chain state** option.
 
     ![](/images/tutorials/interoperability/xcm-channels/hrmp-channels-1.webp)
 
-2. Query the HRMP channels
-    1. Select **`hrmp`**
-    2. Choose the **`hrmpChannels`** call
-    3. Click the **+** button to execute the query
-    4. Check the status of the opened channel
+2. Query the HRMP channels:
+    1. Select **`hrmp`**.
+    2. Choose the **`hrmpChannels`** call.
+    3. Click the **+** button to execute the query.
+    4. Check the status of the opened channel.
 
     ![](/images/tutorials/interoperability/xcm-channels/para-to-para/hrmp-para-to-para-7.webp)
 

tutorials/interoperability/xcm-channels/para-to-system.md

@@ -19,10 +19,10 @@ Any parachain can establish a bidirectional channel with a system chain through
 To successfully complete this process, you'll need to have the following in place:
 
 - Access to a blockchain network consisting of:
-    - A relay chain
-    - A parachain
-    - An Asset Hub system chain
-- A wallet containing enough funds to cover transaction fees on each of the participating chains
+    - A relay chain.
+    - A parachain.
+    - An Asset Hub system chain.
+- A wallet containing enough funds to cover transaction fees on each of the participating chains.
 
 ## Procedure to Establish an HRMP Channel
 
@@ -41,12 +41,12 @@ Use [Polkadot.js Apps](https://polkadot.js.org/apps/#/explorer){target=\_blank}
 
     1. Determine if the parachain is an "up/down" chain (parent or child) or a "sibling" chain:
 
-        - Up/down chains use the prefix `0x70617261` (which decodes to `b"para"`)
+        - Up/down chains use the prefix `0x70617261` (which decodes to `b"para"`).
 
-        - Sibling chains use the prefix `0x7369626c` (which decodes to `b"sibl"`)
+        - Sibling chains use the prefix `0x7369626c` (which decodes to `b"sibl"`).
 
     2. Calculate the u32 scale encoded value of the parachain ID:
-        - Parachain 2500 would be encoded as `c4090000`
+        - Parachain 2500 would be encoded as `c4090000`.
 
     3. Combine the prefix and parachain ID encoding to form the full sovereign account address:
 
@@ -57,41 +57,41 @@ Use [Polkadot.js Apps](https://polkadot.js.org/apps/#/explorer){target=\_blank}
 
 ### Create Establish Channel with System Extrinsic
 
-1. In Polkadot.js Apps, connect to the relay chain, navigate to the **Developer** dropdown and select the **Extrinsics** option
+1. In Polkadot.js Apps, connect to the relay chain, navigate to the **Developer** dropdown and select the **Extrinsics** option.
 
     ![](/images/tutorials/interoperability/xcm-channels/para-to-para/hrmp-para-to-para-1.webp)
 
-2. Construct an `establish_channel_with_system` extrinsic call
+2. Construct an `establish_channel_with_system` extrinsic call:
 
-    1. Select the **`hrmp`** pallet
-    2. Choose the **`establish_channel_with_system`** extrinsic
+    1. Select the **`hrmp`** pallet.
+    2. Choose the **`establish_channel_with_system`** extrinsic.
     3. Fill in the parameters:
-        - **`target_system_chain`** - parachain ID of the target system chain (in this case, 1000)
-    4. Copy the encoded call data
+        - **`target_system_chain`**: Parachain ID of the target system chain (in this case, 1000).
+    4. Copy the encoded call data.
     ![](/images/tutorials/interoperability/xcm-channels/para-to-system/hrmp-para-to-system-1.webp)
     The encoded call data for establishing a channel with system parachain 1000 should be `0x3c0ae8030000`
 
 ### Craft and Submit the XCM Message
 
 Connect to parachain 2500 using Polkadot.js Apps to send the XCM message to the relay chain. Input the necessary parameters as illustrated in the image below. Make sure to:
 
-1. Insert your previously encoded `establish_channel_with_system` call data into the **`call`** field
-2. Provide beneficiary details
-3. Dispatch the XCM message to the relay chain by clicking the **Submit Transaction** button
+1. Insert your previously encoded `establish_channel_with_system` call data into the **`call`** field.
+2. Provide beneficiary details.
+3. Dispatch the XCM message to the relay chain by clicking the **Submit Transaction** button.
 ![](/images/tutorials/interoperability/xcm-channels/para-to-system/hrmp-para-to-system-2.webp)
 
 !!! note
     The exact process and parameters for submitting this XCM message may vary depending on your specific parachain and relay chain configurations. Always refer to the most current documentation for your particular network setup.
 
 After successfully submitting the XCM message to the relay chain, two HRMP channels should be created, establishing bidirectional communication between parachain 2500 and system chain 1000. To verify this, follow these steps:
 
-1. Using Polkadot.js Apps, connect to the relay chain and navigate to the **Developer** dropdown, then select **Chain state**
+1. Using Polkadot.js Apps, connect to the relay chain and navigate to the **Developer** dropdown, then select **Chain state**.
     ![](/images/tutorials/interoperability/xcm-channels/hrmp-channels-1.webp)
 
-2. Query the HRMP channels
-    1. Select **`hrmp`** from the options
-    2. Choose the **`hrmpChannels`** call
-    3. Click the **+** button to execute the query
+2. Query the HRMP channels:
+    1. Select **`hrmp`** from the options.
+    2. Choose the **`hrmpChannels`** call.
+    3. Click the **+** button to execute the query.
     ![](/images/tutorials/interoperability/xcm-channels/para-to-system/hrmp-para-to-system-3.webp)
 
 3. Examine the query results. You should see output similar to the following:
@@ -101,7 +101,7 @@ After successfully submitting the XCM message to the relay chain, two HRMP chann
 
 The output confirms the successful establishment of two HRMP channels:
 
-- From chain 1000 (system chain) to chain 2500 (parachain)
-- From chain 2500 (parachain) to chain 1000 (system chain)
+- From chain 1000 (system chain) to chain 2500 (parachain).
+- From chain 2500 (parachain) to chain 1000 (system chain).
 
 This bidirectional channel enables direct communication between the system chain and the parachain, allowing for cross-chain message passing.