diff --git a/prdoc/pr_1178.prdoc b/prdoc/pr_1178.prdoc
index 36c3b05c7a3f0166e606fe2c2ce1c8801ee0a0c2..528e523c4328c3f18551ea4ce3d6c0955dd5a63a 100644
--- a/prdoc/pr_1178.prdoc
+++ b/prdoc/pr_1178.prdoc
@@ -6,9 +6,9 @@ doc:
       Changed approval-voting, approval-distribution to send all messages tranche0 assignments in one message.
       This required:
       * A new parachains_db version.
-      * A new validation protocol to support the new message types. 
+      * A new validation protocol to support the new message types.
       The new logic will be disabled and will be enabled at a later date after all validators have upgraded.
-   
+
 migrations:
   db:
     - name: Parachains database change from v3 to v4.
@@ -18,6 +18,5 @@ migrations:
 
 crates:
   - name: "polkadot"
-    semver: patch
 
 host_functions: []
diff --git a/prdoc/pr_1246.prdoc b/prdoc/pr_1246.prdoc
index f9c867812331bfdd18f7c14a38a1dcc735cd2c9c..a4d270c45cb5915760ddfbd60e5e4b3b7c08cd4a 100644
--- a/prdoc/pr_1246.prdoc
+++ b/prdoc/pr_1246.prdoc
@@ -1,17 +1,17 @@
 title: Use the `Message Queue` Pallet for DMP and XCMP dispatch queueing
 
 doc:
-  - audience: Parachain Dev
+  - audience: Runtime Dev
     description: Replaces the queueing capabilities of the `DMP and `XCMP-Queue` pallet for incoming messages with the `MessageQueue` pallet. This simplifies the code and improves security.
 
 migrations:
   runtime:
     -
-      pallet: "cumulus_pallet_dmp_queue"
+      reference: cumulus_pallet_dmp_queue
       description: "Messages from the DMP dispatch queue will be moved over to the MQ pallet via `on_initialize`. This happens over multiple blocks and emits a `Completed` event at the end. The pallet can be un-deployed and deleted afterwards. Note that the migration reverses the order of messages, which should be acceptable as a one-off."
 
 crates:
-  - name: "cumulus_pallet_xcmp_queue"
+  - name: cumulus_pallet_xcmp_queue
     note: Pallet config must be altered according to the MR description.
 
 host_functions: []
diff --git a/prdoc/pr_1289.prdoc b/prdoc/pr_1289.prdoc
index f3d8801d9d82efc4be2f9f0b0ee45c1c593ae9f7..059d7608ba6380b5b8d1b0c9edf93b2c619aa34a 100644
--- a/prdoc/pr_1289.prdoc
+++ b/prdoc/pr_1289.prdoc
@@ -4,25 +4,26 @@
 title: Supporting paged rewards allowing all nominators to be rewarded
 
 doc:
-  - audience: Validator
+  - audience: Node Operator
     description: |
       We used to clip top `MaxNominatorRewardedPerValidator` nominators by stake that are eligible for staking reward.
       This was done to limit computation cost of paying out rewards. This PR introduces paging to reward payouts,
       meaning we still clip nominators upto MaxExposurePageSize per page and there could be multiple pages of rewards to
       be paid out. Validators get commission pro-rata to the amount of reward that is paid out for the page.
 
-    notes:
-      - payout_stakers should be called multiple times, once for each page of nominators.
-      - payout_stakers_by_page can be used to pay out rewards for a specific page.
-      - Some old non-paged era storage items are deprecated, and can be removed in a future upgrade.
+      notes:
+        - payout_stakers should be called multiple times, once for each page of nominators.
+        - payout_stakers_by_page can be used to pay out rewards for a specific page.
+        - Some old non-paged era storage items are deprecated, and can be removed in a future upgrade.
 
 migrations:
   db: []
 
   runtime:
-    - { pallet: "pallet-staking", description: "v14: Migration of era exposure storage items to paged exposures."}
+    - reference: pallet-staking
+      description: "v14: Migration of era exposure storage items to paged exposures."
 
 crates:
   - name: pallet-staking
 
-host_functions: []
\ No newline at end of file
+host_functions: []
diff --git a/prdoc/pr_1805.prdoc b/prdoc/pr_1805.prdoc
index 8a8e6c2fde2665eca306ff3adc8a2e701cc29a7d..30f0fbea3070f1e819df2f12f866d6a6f5a2a78f 100644
--- a/prdoc/pr_1805.prdoc
+++ b/prdoc/pr_1805.prdoc
@@ -1,7 +1,7 @@
 title: Introduce state decoding check after runtime upgrades.
 
 doc:
-  - audience: Core Dev
+  - audience: Runtime Dev
     description: |
       Adds a check to the try-runtime logic that will verify that all pallet on-chain storage still decodes. This can help to spot missing migrations before they become a problem. The check is enabled as soon as the `--checks` option of the `try-runtime` CLI is not `None`.
 
@@ -10,10 +10,8 @@ migrations:
 
   runtime: []
 
-crates: 
+crates:
   - name: frame-support
-    semver: minor
   - name: frame-support-procedural
-    semver: minor
 
 host_functions: []
diff --git a/prdoc/pr_1926.prdoc b/prdoc/pr_1926.prdoc
index 9dc656f1260d068b3632b381302e8157e2c47b09..e7c4293d9fd452017af8e1fe9cd4e623558a8d88 100644
--- a/prdoc/pr_1926.prdoc
+++ b/prdoc/pr_1926.prdoc
@@ -1,10 +1,10 @@
 title: Adds syntax for marking calls feeless
 
 doc:
-  - audience: Core Dev
+  - audience: Runtime Dev
     description: |
       1. Adds an attribute `#[pallet::feeless_if]` that can be optionally attached to a `pallet::call`.
-      2. Adds a signed extension SkipCheckIfFeeless<T: SignedExtension> that wraps a transaction 
+      2. Adds a signed extension SkipCheckIfFeeless<T: SignedExtension> that wraps a transaction
       payment processor to potentially skip payment fees for such calls.
       Note that both the attribute and the signed extension are needed to make the call feeless.
 
@@ -14,17 +14,11 @@ migrations:
   runtime: []
 
 crates:
-  - name: "frame-support-procedural"
-    semver: minor
-  - name: "pallet-skip-feeless-payment"
-    semver: major
-  - pallet-example-kitchensink
-    semver: patch
-  - kitchensink-runtime
-    semver: major
-  - node-testing
-    semver: patch
-  - node-cli
-    semver: patch
+  - name: frame-support-procedural
+  - name: pallet-skip-feeless-payment
+  - name: pallet-example-kitchensink
+  - name: kitchensink-runtime
+  - name: node-testing
+  - name: node-cli
 
 host_functions: []
diff --git a/prdoc/pr_2086.prdoc b/prdoc/pr_2086.prdoc
index a9bbd0729d5b08b8b2d482ba062ece9e443458a3..3bd568cc139883d70fe7556c18b017f1fc12965a 100644
--- a/prdoc/pr_2086.prdoc
+++ b/prdoc/pr_2086.prdoc
@@ -1,15 +1,12 @@
 title: "Contracts: Add XCM traits to interface with contracts"
 
 doc:
-  - audience: Core Dev
+  - audience: Runtime Dev
     description: |
       We are introducing a new set of `XcmController` traits in `pallet-xcm`.
-      These traits extract functionality from `pallet-xcm` and provide high-level interaction with XCM. 
+      These traits extract functionality from `pallet-xcm` and provide high-level interaction with XCM.
       They enable other pallets, like `pallet_contracts`, to rely on these traits instead of tight coupling to `pallet-xcm` itself.
 
 crates:
-    - name: "pallet-xcm"
-      semver: patch
-    - name: "xcm-executor"
-      semver: patch
-
+  - name: pallet-xcm
+  - name: xcm-executor
diff --git a/prdoc/pr_2107.prdoc b/prdoc/pr_2107.prdoc
index 0e33680555ace33797db4dcc73f3d003eb1d5a23..be71828cbad5cf76e4ab9c1a5c9d11e2aa61a48c 100644
--- a/prdoc/pr_2107.prdoc
+++ b/prdoc/pr_2107.prdoc
@@ -4,14 +4,16 @@
 title: Add a builder pattern to create XCM programs
 
 doc:
-  - audience: Core Dev
+  - audience: Runtime Dev
     description: |
       XCMs can now be built using a builder pattern like so:
+      ```
       Xcm::builder()
         .withdraw_asset(assets)
         .buy_execution(fees, weight_limit)
         .deposit_asset(assets, beneficiary)
         .build();
+      ```
 
 migrations:
   db: []
diff --git a/prdoc/pr_2142.prdoc b/prdoc/pr_2142.prdoc
index ae2ac3db9ddc9627ee14fb23e2d6374934be982c..1d37941134601cc6016c408228c74ea655de1ad3 100644
--- a/prdoc/pr_2142.prdoc
+++ b/prdoc/pr_2142.prdoc
@@ -1,12 +1,12 @@
 title: Cleanup XCMP `QueueConfigData`
 
 doc:
-  - audience: Parachain Dev
+  - audience: Runtime Dev
     description: Removes obsolete fields from the `QueueConfigData` structure. For the remaining fields, if they use the old defaults, we replace them with the new defaults.
 
 migrations:
   runtime:
-    - pallet: "cumulus_pallet_xcmp_queue"
+    - reference: cumulus_pallet_xcmp_queue
       description: "v4: Removes obsolete fields from the `QueueConfigData` structure. For the remaining fields, if they use the old defaults, we replace them with the new defaults."
 
 crates: []
diff --git a/prdoc/pr_2165.prdoc b/prdoc/pr_2165.prdoc
index 31cb691c43aabb58c81de10ca91abedaeaae0bb0..3b10bcfe6a5210bf9dc60ce1d1edf6b653e71b82 100644
--- a/prdoc/pr_2165.prdoc
+++ b/prdoc/pr_2165.prdoc
@@ -1,7 +1,7 @@
-title: Add sudo::remove_key
+title: Add `sudo::remove_key`
 
 doc:
-  - audience: Core Dev
+  - audience: Runtime User
     description: |
       Pallet `Sudo` now has the ability to remove the sudo key via `remove_key`. This is a less-invasive way of rendering the sudo pallet useless without needing a code upgrade.
 
@@ -12,6 +12,5 @@ migrations:
 
 crates:
   - name: pallet-sudo
-    semver: minor
 
 host_functions: []
diff --git a/prdoc/pr_2253.prdoc b/prdoc/pr_2253.prdoc
index 398b0a29066baa1dd2cd353177a96d4cff895b47..8a6dac754d1fc8a28c7610c078a164e952aceeea 100644
--- a/prdoc/pr_2253.prdoc
+++ b/prdoc/pr_2253.prdoc
@@ -4,7 +4,7 @@
 title: Different builder pattern constructors for XCM
 
 doc:
-  - audience: Core Dev
+  - audience: Runtime Dev
     description: |
       The `builder()` constructor for XCM programs now only allows building messages that pay for fees,
       i.e. messages that would pass the `AllowTopLevelPaidExecutionFrom` barrier.