formatting

Author: brunopgalvao

develop/parachains/maintenance/configure-asynchronous-backing.md

@@ -35,6 +35,7 @@ This can be found in the relay chain's runtime. You can see the Polkadot [`async
 This phase involves configuring your parachain's runtime `/runtime/src/lib.rs` to make use of async backing system.
 
 1. Establish and ensure that constants for capacity ([`UNINCLUDED_SEGMENT_CAPACITY`](https://github.com/polkadot-fellows/runtimes/blob/d49a9f33d0ea85ce51c26c84a70b61624ec06901/system-parachains/constants/src/polkadot.rs#L42-L44){target=\_blank}) and velocity ([`BLOCK_PROCESSING_VELOCITY`](https://github.com/polkadot-fellows/runtimes/blob/d49a9f33d0ea85ce51c26c84a70b61624ec06901/system-parachains/constants/src/polkadot.rs#L45-L47){target=\_blank}) are both set to `1` in the runtime.
+
 2. Establish and ensure the constant relay chain slot duration measured in milliseconds equal to `6000` in the runtime.
 
     ```rust title="lib.rs"
@@ -59,7 +60,7 @@ This phase involves configuring your parachain's runtime `/runtime/src/lib.rs` t
     pub const SLOT_DURATION: u64 = MILLISECS_PER_BLOCK;
     ```
 
-4. Configure `cumulus_pallet_parachain_system` in the runtime.
+4. Configure [`cumulus_pallet_parachain_system`](https://paritytech.github.io/polkadot-sdk/master/cumulus_pallet_parachain_system/index.html){target=\_blank} in the runtime.
 
     - Define a [`FixedVelocityConsensusHook`](https://paritytech.github.io/polkadot-sdk/master/cumulus_pallet_aura_ext/consensus_hook/struct.FixedVelocityConsensusHook.html){target=\_blank} using our capacity, velocity, and relay slot duration constants. 
     ```rust title="lib.rs"
@@ -74,36 +75,36 @@ This phase involves configuring your parachain's runtime `/runtime/src/lib.rs` t
     - Use this to set the parachain system [`ConsensusHook`](https://paritytech.github.io/polkadot-sdk/master/cumulus_pallet_parachain_system/pallet/trait.Config.html#associatedtype.ConsensusHook){target=\_blank} property.
     ```rust title="lib.rs"
     impl cumulus_pallet_parachain_system::Config for Runtime {
-        ..
+        ...
         type ConsensusHook = ConsensusHook;
-        ..
+        ...
     }
     ```
 
     - Set the parachain system property [`CheckAssociatedRelayNumber`](https://paritytech.github.io/polkadot-sdk/master/cumulus_pallet_parachain_system/pallet/trait.Config.html#associatedtype.CheckAssociatedRelayNumber){target=\_blank} to [`RelayNumberMonotonicallyIncreases`](https://paritytech.github.io/polkadot-sdk/master/cumulus_pallet_parachain_system/struct.RelayNumberMonotonicallyIncreases.html){target=\_blank}
     ```rust title="lib.rs"
     impl cumulus_pallet_parachain_system::Config for Runtime {
-        ..
+        ...
         type CheckAssociatedRelayNumber = RelayNumberMonotonicallyIncreases;
-        ..
+        ...
     }
     ```
 
 5. Configure [`pallet_aura`](https://paritytech.github.io/polkadot-sdk/master/pallet_aura/index.html){target=\_blank} in the runtime.
 
-    [`pallet_aura`]((https://paritytech.github.io/polkadot-sdk/master/pallet_aura/index.html){target=\_blank}) implements Authority Round (Aura) - a deterministic [consensus](https://docs.polkadot.com/polkadot-protocol/glossary/#consensus){target=\_blank} protocol where block production is limited to a rotating list of authorities that take turns creating blocks. [`pallet_aura`](https://paritytech.github.io/polkadot-sdk/master/pallet_aura/index.html){target=\_blank} uses [`pallet_timestamp`](https://paritytech.github.io/polkadot-sdk/master/pallet_timestamp/index.html){target=\_blank} to track consensus rounds (via [`slots`](https://paritytech.github.io/polkadot-sdk/master/pallet_aura/pallet/trait.Config.html#associatedtype.SlotDuration){target=\_blank}).
+    [`pallet_aura`]((https://paritytech.github.io/polkadot-sdk/master/pallet_aura/index.html){target=\_blank}) implements Authority Round (Aura) - a deterministic [consensus](/polkadot-protocol/glossary/#consensus){target=\_blank} protocol where block production is limited to a rotating list of authorities that take turns creating blocks. [`pallet_aura`](https://paritytech.github.io/polkadot-sdk/master/pallet_aura/index.html){target=\_blank} uses [`pallet_timestamp`](https://paritytech.github.io/polkadot-sdk/master/pallet_timestamp/index.html){target=\_blank} to track consensus rounds (via [`slots`](https://paritytech.github.io/polkadot-sdk/master/pallet_aura/pallet/trait.Config.html#associatedtype.SlotDuration){target=\_blank}).
 
     - Set [`AllowMultipleBlocksPerSlot`](https://paritytech.github.io/polkadot-sdk/master/pallet_aura/pallet/trait.Config.html#associatedtype.AllowMultipleBlocksPerSlot){target=\_blank} to `false` 
-        - We will set it to `true` when we activate async backing in phase 3
+        - This will be set to `true` when we activate async backing in phase 3
 
     - Define [`pallet_aura::SlotDuration`](https://paritytech.github.io/polkadot-sdk/master/pallet_aura/pallet/trait.Config.html#associatedtype.SlotDuration){target=\_blank} using our constant [`SLOT_DURATION`](https://github.com/polkadot-fellows/runtimes/blob/d49a9f33d0ea85ce51c26c84a70b61624ec06901/system-parachains/constants/src/lib.rs#L38-L40){target=\_blank}
     ```rust title="lib.rs"
     impl pallet_aura::Config for Runtime {
-        ..
+        ...
         type AllowMultipleBlocksPerSlot = ConstBool<false>;
         #[cfg(feature = "experimental")]
         type SlotDuration = ConstU64<SLOT_DURATION>;
-        ..
+        ...
     }
     ```
 
@@ -119,14 +120,14 @@ This phase involves configuring your parachain's runtime `/runtime/src/lib.rs` t
 
     - Add the dependency [`cumulus-primitives-aura`](https://paritytech.github.io/polkadot-sdk/master/cumulus_primitives_aura/index.html){target=\_blank} to the `runtime/Cargo.toml` file for your runtime
     ```rust title="Cargo.toml"
-    ..
+    ...
     cumulus-primitives-aura = { path = "../../../../primitives/aura", default-features = false }
-    ..
+    ...
     ```
 
     - In the same file, add `"cumulus-primitives-aura/std",` to the `std` feature.
 
-    - Inside the [`impl_runtime_apis!`]((https://github.com/paritytech/polkadot-sdk/blob/6b17df5ae96f7970109ec3934c7d288f05baa23b/templates/parachain/runtime/src/apis.rs#L87-L91){target=\_blank}) block for your runtime, implement the [`cumulus_primitives_aura::AuraUnincludedSegmentApi`](https://paritytech.github.io/polkadot-sdk/master/cumulus_primitives_aura/trait.AuraUnincludedSegmentApi.html){target=\_blank} as shown below.
+    - Inside the [`impl_runtime_apis!`](https://github.com/paritytech/polkadot-sdk/blob/6b17df5ae96f7970109ec3934c7d288f05baa23b/templates/parachain/runtime/src/apis.rs#L87-L91){target=\_blank} block for your runtime, implement the [`cumulus_primitives_aura::AuraUnincludedSegmentApi`](https://paritytech.github.io/polkadot-sdk/master/cumulus_primitives_aura/trait.AuraUnincludedSegmentApi.html){target=\_blank} as shown below.
     ```rust title="apis.rs"
 	impl cumulus_primitives_aura::AuraUnincludedSegmentApi<Block> for Runtime {
 		fn can_build_upon(
@@ -138,7 +139,7 @@ This phase involves configuring your parachain's runtime `/runtime/src/lib.rs` t
     ```
 
     !!!note
-        With a capacity of 1 we have an effective velocity of ½ even when velocity is configured to some larger value. This is because capacity will be filled after a single block is produced and will only be freed up after that block is included on the relay chain, which takes 2 relay blocks to accomplish. Thus with capacity 1 and velocity 1 we get the customary 12 second parachain block time.
+        With a capacity of 1 you have an effective velocity of ½ even when velocity is configured to some larger value. This is because capacity will be filled after a single block is produced and will only be freed up after that block is included on the relay chain, which takes 2 relay blocks to accomplish. Thus with capacity 1 and velocity 1 you get the customary 12 second parachain block time.
 
 8. If your `runtime/src/lib.rs` provides a [`CheckInherents`](https://paritytech.github.io/polkadot-sdk/master/cumulus_pallet_parachain_system/macro.register_validate_block.html){target=\_blank} type to [`register_validate_block`](https://paritytech.github.io/polkadot-sdk/master/cumulus_pallet_parachain_system/macro.register_validate_block.html), remove it. [`FixedVelocityConsensusHook`](https://paritytech.github.io/polkadot-sdk/master/cumulus_pallet_aura_ext/consensus_hook/struct.FixedVelocityConsensusHook.html){target=\_blank} makes it unnecessary. The following example shows how `register_validate_block` should look after removing `CheckInherents`.
 
@@ -166,27 +167,27 @@ This phase consists of plugging in the new lookahead collator node.
 
     ```rust title="node/src/service.rs"
     sc_service::spawn_tasks(sc_service::SpawnTasksParams {
-        ..
+        ...
         backend: backend.clone(),
-        ..
+        ...
     })?;
     ```
 
 3. Add `backend` as a parameter to [`start_consensus()`](https://paritytech.github.io/polkadot-sdk/master/parachain_template_node/service/fn.start_consensus.html){target=\_blank} in `node/src/service.rs`
 
     ```rust title="node/src/service.rs"
     fn start_consensus(
-        ..
+        ...
         backend: Arc<ParachainBackend>,
-        ..
+        ...
     ```
 
     ```rust title="node/src/service.rs"
     if validator {
     start_consensus(
-        ..
+        ...
         backend.clone(),
-        ..
+        ...
     )?;
     }
     ```
@@ -206,16 +207,16 @@ This phase consists of plugging in the new lookahead collator node.
     - Increase [`authoring_duration`](https://github.com/paritytech/polkadot-sdk/blob/6b17df5ae96f7970109ec3934c7d288f05baa23b/templates/parachain/node/src/service.rs#L206-L225){target=\_blank} from 500 milliseconds to 2000
     ```rust title="node/src/service.rs"
     let params = AuraParams {
-        ..
+        ...
         para_client: client.clone(),
         para_backend: backend.clone(),
-        ..
+        ...
         code_hash_provider: move |block_hash| {
             client.code_at(block_hash).ok().map(|c| ValidationCode::from(c).hash())
         },
-        ..
+        ...
         authoring_duration: Duration::from_millis(2000),
-        ..
+        ...
     };
     ```
 
@@ -235,8 +236,7 @@ This phase consists of plugging in the new lookahead collator node.
 
 This phase consists of changes to your parachain's runtime that activate async backing feature.
 
-1. Configure [`pallet_aura`](https://paritytech.github.io/polkadot-sdk/master/pallet_aura/index.html){target=\_blank}, setting [`AllowMultipleBlocksPerSlot`](https://paritytech.github.io/polkadot-sdk/master/pallet_aura/pallet/trait.Config.html#associatedtype.AllowMultipleBlocksPerSlot){target=\_blank} to true in
-   `runtime/src/lib.rs`.
+1. Configure [`pallet_aura`](https://paritytech.github.io/polkadot-sdk/master/pallet_aura/index.html){target=\_blank}, setting [`AllowMultipleBlocksPerSlot`](https://paritytech.github.io/polkadot-sdk/master/pallet_aura/pallet/trait.Config.html#associatedtype.AllowMultipleBlocksPerSlot){target=\_blank} to true in `runtime/src/lib.rs`.
 
     ```rust title="runtime/src/lib.rs"
     impl pallet_aura::Config for Runtime {
@@ -266,7 +266,7 @@ This phase consists of changes to your parachain's runtime that activate async b
 3. Decrease [`MILLI_SECS_PER_BLOCK`](https://github.com/paritytech/polkadot-sdk/blob/6b17df5ae96f7970109ec3934c7d288f05baa23b/templates/parachain/runtime/src/lib.rs#L182-L194){target=\_blank} to 6000.
 
     !!!note
-        For a parachain which measures time in terms of its own block number rather than by relay block number it may be preferable to increase velocity. Changing block time may cause complications, requiring additional changes. See the section "Timing by Block Number".
+        For a parachain which measures time in terms of its own block number rather than by relay block number it may be preferable to increase velocity. Changing block time may cause complications, requiring additional changes. See the section [Timing by Block Number](#timing-by-block-number){target=\_blank}.
 
     ```rust title="runtime/src/lib.rs"
     mod block_times {
@@ -297,9 +297,9 @@ This phase consists of changes to your parachain's runtime that activate async b
 
     ```rust title="runtime/src/lib.rs"
     impl pallet_timestamp::Config for Runtime {
-        ..
+        ...
         type MinimumPeriod = ConstU64<0>;
-        ..
+        ...
     }
     ```