Remove and replace XCM docs (#106)

* remove and replace XCM docs * fix all warnings / info
w3f · Feb 21, 2025 · 52ad3e2 · 52ad3e2 · github-actions · Feb 21, 2025
1 parent 66d131b
commit 52ad3e2
Show file tree

Hide file tree

Showing 74 changed files with 48 additions and 4,050 deletions.
diff --git a/_redirects b/_redirects
@@ -30,6 +30,12 @@
 /docs/build-hackathon    /build/build-hackathon    301
 /docs/build-archive-index    /build/archive    301
 /docs/learn-xcm    /learn/learn-xcm    301
+/docs/learn-xcm-pallet    /learn/learn-xcm    301
+/docs/learn-xcm-transport    /learn/learn-xcm-transport    301
+/docs/learn-xcvm    /learn/learn-xcvm    301
+/docs/learn-xcm-instructions    /learn/learn-xcm-instructions    301
+/docs/learn-xcm-usecases    /learn/learn-xcm-usecases   301
+/docs/learn-xcm-*   /learn/learn-xcm    301
 /docs/learn-agile-coretime    /learn/learn-agile-coretime    301
 /docs/build-open-source    /general/build-open-source    301
 /docs/learn-parachains    /learn/learn-parachains    301
@@ -130,6 +136,7 @@
 /docs/learn-runtime-upgrades    /learn/learn-runtime-upgrades    301
 /docs/learn/xcm/introduction    /learn/learn-xcm    301
 /docs/learn/xcm/overview    /learn/learn-xcm    301
+/docs/learn/xcm/*    /learn/learn-xcm    301
 /docs/learn-*    /general/web3-and-polkadot    301
 /docs/build-*    /build/build-guide    301
 /docs/*    /general/getting-started    301
diff --git a/docs/.DS_Store b/docs/.DS_Store
diff --git a/docs/assets/.DS_Store b/docs/assets/.DS_Store
diff --git a/docs/assets/guides/.DS_Store b/docs/assets/guides/.DS_Store
diff --git a/docs/build/build-guides-template-basic.md b/docs/build/build-guides-template-basic.md
@@ -428,5 +428,5 @@ Now that you can launch a layer one blockchain, the possibilities are endless:
 
 - Setup a local development environment for your parachain
 - Create a pallet
-- [Take a look at the OpenZepplin template - which has a lot more pallets configured.](build-guides-coretime-start.md#openzeppelin-templates--guides)
+- [Take a look at the OpenZepplin template - which has a lot more pallets configured.](build-guides-coretime-start.md#openzeppelin-templates-guides)
 - Upgrade your network
diff --git a/docs/build/build-integrate-assets.md b/docs/build/build-integrate-assets.md
@@ -86,7 +86,7 @@ implemented in the Asset Hub runtime. This signed-extension extends transactions
 optional `AssetId` that specifies the asset to be used for payment of both the execution fees and
 the optional tip. It defaults to the native token when it is set to `None`. In case it is given,
 this `AssetId` has to be an
-[XCM `Multilocation`](../learn/xcm/fundamentals/multilocation/summary.md). Once the transaction
+[XCM `Multilocation`](https://paritytech.github.io/polkadot-sdk/master/collectives_westend_integration_tests/v3/struct.MultiLocation.html). Once the transaction
 is executed in the block, it will emit an `AssetTxFeePaid` event, informing of the account paying
 the fees, the amount in the asset paid as fee, the tip (if any), and the asset ID of the asset
 paying the fees.
@@ -201,7 +201,7 @@ their system. For this, the service provider must query every new block created,
 events array, filter for any `balances.minted` event, and apply the appropriate business logic.
 
 In some special cases, DOT may be sent to the relay chain or the Asset Hub using other XCM instructions, 
-like [`Transact`](../learn/xcm/journey/transact.md).
+like [`Transact`](https://paritytech.github.io/polkadot-sdk/master/staging_xcm/v5/opaque/type.Instruction.html#variant.Transact).
 In these cases, the event emitted when processing the transact instruction in the destination chain is 
 `balances.transfer`, which is usually emitted during the finalization of the block execution process.
 

diff --git a/docs/build/build-open-source.md b/docs/build/build-open-source.md
@@ -235,6 +235,7 @@ In the below sections, you can find a list of different layers of the Polkadot S
 | ------------------- | --------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
 | Storage             | [Merkle Tree DB](https://github.com/frisitano/merkle-tree-db) ⚪|                                  |
 | Merkle Proofs       | [Solidity Trie Verifier](https://github.com/polytope-labs/solidity-merkle-trees) 🟡| |
+
 ## Contributing
 
 Pull requests, issues, or other contributions from the community are encouraged! You can not only

diff --git a/docs/general/build-open-source.md b/docs/general/build-open-source.md
diff --git a/docs/general/getting-started.md b/docs/general/getting-started.md
@@ -17,7 +17,7 @@ Polkadot. For more information about Polkadot see the dedicated page about the s
 
 Polkadot has an on-chain [open governance](../learn/learn-polkadot-opengov.md) (also called Polkadot
 OpenGov) to orchestrate decisions, including accessing funds from the
-[treasury](learn-polkadot-opengov-treasury.md).
+[treasury](../learn/learn-polkadot-opengov-treasury.md).
 
 The [DOT token](../learn/learn-DOT.md) gives you the power to participate in Polkadot OpenGov, and
 [staking](../learn/learn-staking.md).

diff --git a/docs/general/grants.md b/docs/general/grants.md
@@ -35,14 +35,14 @@ The Polkadot Treasury is a pot of on-chain funds collected through transaction f
 can be spent on spending proposals. Both Polkadot and Kusama offer everyone the opportunity to apply
 for funding via the treasury. See:
 
-- [Treasury Wiki](learn-polkadot-opengov-treasury.md)
+- [Treasury Wiki](../learn/learn-polkadot-opengov-treasury.md)
 - [Polkadot Treasury Guide](https://docs.google.com/document/d/1IZykdp2cyQavcRyZd_dgNj5DcgxgZR6kAqGdcNARu1w)
 - [Kusama Treasury Guide](https://docs.google.com/document/d/1p3UQUjph5t8TVaWnTkfrI5mE-BABnM9Xvtuhdlhl6JE)
 
 !!!info "Kusama Faucet"
     Due to high demand and spamming issues, the Kusama faucet is no longer in operation. The Web3 Foundation has considered new ways to distribute KSM for people who need KSM to build.
 
-    If you are interested in obtaining KSM for building or research, you can apply through the [Treasury](learn-polkadot-opengov-treasury.md) or receive a [tip](learn-polkadot-opengov-treasury.md#treasury-tracks) for doing something cool in the community.
+    If you are interested in obtaining KSM for building or research, you can apply through the [Treasury](../learn/learn-polkadot-opengov-treasury.md) or receive a [tip](../learn/learn-polkadot-opengov-treasury.md#treasury-tracks) for doing something cool in the community.
 
 ### Other Grant Programs
 

diff --git a/docs/general/learn-polkadot-opengov-treasury.md b/docs/general/learn-polkadot-opengov-treasury.md
diff --git a/docs/general/metadata.md b/docs/general/metadata.md
diff --git a/docs/general/scams.md b/docs/general/scams.md
@@ -42,7 +42,7 @@ share these with anyone, they can access your account and execute any transactio
 2. Be careful with extensions/applications and typing in recovery seeds or importing backup JSON
    files in there, they could be malicious or pretend to be a well-known wallet.
 3. Do not trust anyone online. Malicious actors often pretend to be someone else to gain your trust.
-4. [If you are scammed](#i-got-scammed---what-can-i-do), there is likely **nothing that can be
+4. [If you are scammed](#i-got-scammed-what-can-i-do), there is likely **nothing that can be
    done** to recover your funds. If a scammer gets a hold of your seed phrase, they can transfer all
    your funds to their account in seconds.
 5. If it sounds too good to be true, it probably is. People, especially celebrities, do not give

diff --git a/docs/learn/.DS_Store b/docs/learn/.DS_Store
diff --git a/docs/learn/learn-accounts.md b/docs/learn/learn-accounts.md
@@ -21,8 +21,6 @@ This document covers the basics of accounts in the Polkadot ecosystem. See the
 [indices](./learn-account-advanced.md#indices). For a more in-depth explanation of the cryptography
 behind accounts, please see the [cryptography page](learn-cryptography.md).
 
-<!-- TODO: INDEX CARDS -->
-
 ## Account Address
 
 An address is the public part of an account. The private part is the key used to access this

diff --git a/docs/learn/learn-archive.md b/docs/learn/learn-archive.md
diff --git a/docs/learn/learn-guides-asset-conversion.md b/docs/learn/learn-guides-asset-conversion.md
@@ -36,7 +36,7 @@ liquidity can be added to it via the `Pallet::add_liquidity` function.
 
 For example, the snapshot below shows how to create liquidity pool with `PAS` tokens and `EDU`
 tokens with the asset ID `149` on Paseo Asset Hub. Creating this extrinsic requires knowledge of
-[XCM Multilocations](xcm/fundamentals/multilocation/summary.md). From the perspective of AssetHub,
+[XCM Multilocations](https://paritytech.github.io/polkadot-sdk/master/staging_xcm/v3/struct.MultiLocation.html). From the perspective of AssetHub,
 an Asset Hub, the asset with an `AssetId` of `149` has a MultiLocation of
 
 ```

diff --git a/docs/learn/learn-guides-transfers.md b/docs/learn/learn-guides-transfers.md
@@ -110,7 +110,7 @@ explicitly call an extrinsic to update the lock that is placed on an account.
 
 These extrinsics are exposed from the Vesting pallet.
 
-If you are using [the Polkadot-JS UI](./learn-polkadotjs.md), when there are tokens available to
+If you are using [the Polkadot-JS UI](../general/polkadotjs-ui.md), when there are tokens available to
 vest for an account, you can unlock tokens that have already been vested from the
 [Accounts](https://polkadot.js.org/apps/#/accounts) page.