polkadot-developers · kianenigma · Aug 28, 2024 · Aug 27, 2024 · Aug 27, 2024 · Aug 27, 2024
diff --git a/.netlify/_redirects b/.netlify/_redirects
@@ -1,6 +1,6 @@
 # Redirects from what the browser requests to what we serve
 
-/rustdocs                   https://paritytech.github.io/substrate/master/sc_service/ 301!
+/rustdocs                   https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/index.html 301!
 
 /how-to-guides              /reference/                                               301!
 

diff --git a/content/config/nav.yaml b/content/config/nav.yaml
@@ -1,4 +1,5 @@
 menu:
+  - polkadot-sdk
   - quick-start
   - learn
   - install
@@ -10,8 +11,12 @@ menu:
   - reference
   - community
 
+polkadot-sdk:
+  title: Substrate -> Polkadot SDK
+  url: /polkadot-sdk/
+
 quick-start:
-  title: Quick start
+  title: Quick start (Deprecated)
   url: /quick-start/
   pages:
     - title: Substrate at a glance
@@ -24,7 +29,7 @@ quick-start:
       url: /quick-start/modify-the-runtime/
 
 learn:
-  title: Learn
+  title: Learn (Deprecated)
   url: /learn/
   pages:
     - title: Welcome to Substrate
@@ -69,7 +74,7 @@ learn:
       url: /learn/xcm-communication/
 
 install:
-  title: Install
+  title: Install (Deprecated)
   url: /install/
   pages:
     - title: Rust toolchain
@@ -84,7 +89,7 @@ install:
       url: /install/developer-tools/
     - title: Troubleshoot Rust issues
       url: /install/troubleshoot-rust-issues/
-  
+
 #design:
  # title: Design
  # url: /design/
@@ -106,7 +111,7 @@ install:
   #- title: Economic models
   #url: /design/economic-models/
 build:
-  title: Build
+  title: Build (Deprecated)
   url: /build/
   pages:
     - title: Smart contracts
@@ -143,7 +148,7 @@ build:
     #url: /build/executor/
 
 test:
-  title: Test
+  title: Test (Deprecated)
   url: /test/
   pages:
     - title: Unit test
@@ -156,9 +161,9 @@ test:
       url: /test/simulate-parachains/
     - title: Check runtime
       url: /test/check-runtime/
-      
+
 deploy:
-  title: Deploy
+  title: Deploy (Deprecated)
   url: /deploy/
   pages:
     - title: Prepare to deploy
@@ -174,7 +179,7 @@ deploy:
 #   - title: Launch a parachain
 #     url: /deploy/launch-a-parachain/
 maintain:
-  title: Maintain
+  title: Maintain (Deprecated)
   url: /maintain/
   pages:
     - title: Monitor
@@ -191,7 +196,7 @@ maintain:
 #     url: /maintain/data-migration/
 
 tutorials:
-  title: Tutorials
+  title: Tutorials (Deprecated)
   url: /tutorials/
   pages:
     - title: Build a blockchain
@@ -282,7 +287,7 @@ tutorials:
 #         url: /tutorials/integrate-with-tools/access-evm-accounts/
 
 reference:
-  title: Reference
+  title: Reference (Deprecated)
   url: /reference/
   pages:
     - title: Rust API
@@ -335,7 +340,7 @@ reference:
       url: /reference/how-to-guides/
 
 community:
-  title: Community
+  title: Community (Deprecated)
   url: /community/
   pages:
     - title: Content style guide

diff --git a/content/md/en/docs/build/genesis-configuration.md b/content/md/en/docs/build/genesis-configuration.md
@@ -5,7 +5,7 @@ keywords:
 ---
 
 <div class="warning">
-  <strong>⚠️ WARNING:</strong> This page contains outdated information. Please refer to the <a href="https://paritytech.github.io/polkadot-sdk/master/frame_support/pallet_macros/attr.genesis_build.html">Rust docs</a> for the most up-to-date documentation on this topic.
+  Please refer to the <a href="https://paritytech.github.io/polkadot-sdk/master/frame_support/pallet_macros/attr.genesis_build.html">Rust docs</a> for the most up-to-date documentation on this topic.
 </div>
 
 
@@ -19,7 +19,7 @@ As you learned in [Chain specification](/build/chain-spec/), the chain specifica
 However, the chain specification doesn't create the storage items that get initialized when you start a node.
 Instead, the storage items are defined in the pallets included in the runtime as described in [Runtime storage](/build/runtime-storage/).
 
-After you create storage items for the runtime, you can choose whether they should be set to some initial value as part of the genesis configuration and included in the genesis block.  
+After you create storage items for the runtime, you can choose whether they should be set to some initial value as part of the genesis configuration and included in the genesis block.
 To specify the storage items that you want to set an initial state for, Substrate provides two specialized FRAME attribute macros.
 
 The macros you can use to initialize storage items as part of the genesis configuration for a chain are:
@@ -120,12 +120,17 @@ All of the `GenesisConfig` types for the pallets that included in the constructi
 The aggregated `RuntimeGenesisConfig` implements the [`BuildStorage`](https://paritytech.github.io/substrate/master/sp_runtime/trait.BuildStorage.html) trait to build all of the initial storage items for the runtime.
 For example, the node template runtime builds storage items for the following pallets that have a `RuntimeGenesisConfig` specified by default:
 
-- [System pallet](#system-pallet)
-- [Aura pallet](#aura-pallet)
-- [Grandpa pallet](#grandpa-pallet)
-- [Balances pallet](#balances-pallet)
-- [TransactionPayment pallet](#transactionpayment-pallet)
-- [Sudo pallet](#sudo-pallet)
+- [Configure a simple storage value](#configure-a-simple-storage-value)
+  - [Configure macros in the pallet](#configure-macros-in-the-pallet)
+  - [Configure the chain specification](#configure-the-chain-specification)
+- [Adding genesis configuration to the runtime](#adding-genesis-configuration-to-the-runtime)
+  - [System pallet](#system-pallet)
+  - [Aura pallet](#aura-pallet)
+  - [Grandpa pallet](#grandpa-pallet)
+  - [Balances pallet](#balances-pallet)
+  - [TransactionPayment pallet](#transactionpayment-pallet)
+  - [Sudo pallet](#sudo-pallet)
+- [Initialize storage items within a pallet](#initialize-storage-items-within-a-pallet)
 
 ### System pallet
 

diff --git a/content/md/en/docs/build/origins.md b/content/md/en/docs/build/origins.md
@@ -6,7 +6,7 @@ keywords:
 ---
 
 <div class="warning">
-  <strong>⚠️ WARNING:</strong> This page contains outdated information. Please refer to the <a href="https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/reference_docs/frame_origin/index.html">Rust docs</a> for the most up-to-date documentation on this topic.
+  Please refer to the <a href="https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/reference_docs/frame_origin/index.html">Rust docs</a> for the most up-to-date documentation on this topic.
 </div>
 
 The runtime origin is used by dispatchable functions to check where a call has come from.

diff --git a/content/md/en/docs/build/pallet-coupling.md b/content/md/en/docs/build/pallet-coupling.md
@@ -7,12 +7,7 @@ keywords:
 ---
 
 <div class="warning">
-	<p>
-	<strong>⚠️ WARNING:</strong> This page contains potentially outdated information. Reading it might still be useful, yet we suggest taking it with a grain of salt.
-	</p>
-	<p>
-	 Please refer to the <a href="https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/reference_docs/frame_pallet_coupling/index.html">`polkadot-sdk-docs` crate</a> for the most up-to-date documentation on this topic.
-	</p>
+	 Please refer to the <a href="https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/reference_docs/frame_pallet_coupling/index.html">Rust Docs</a> for the most up-to-date documentation on this topic.
 </div>
 
 The term **coupling** is often used to describe the degree to which two software modules depend on each other.

diff --git a/content/md/en/docs/build/remote-procedure-calls.md b/content/md/en/docs/build/remote-procedure-calls.md
@@ -7,7 +7,7 @@ keywords:
 ---
 
 <div class="warning">
-  <strong>⚠️ WARNING:</strong> This page may contain outdated information. Please refer to the <a href="https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/reference_docs/custom_runtime_api_rpc/index.html">Rust docs</a> for the most up-to-date documentation on this topic.
+  Please refer to the <a href="https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/reference_docs/custom_runtime_api_rpc/index.html">Rust docs</a> for the most up-to-date documentation on this topic.
 </div>
 
 Remote procedure calls, or RPC methods, are a way for an external program—for example, a browser or front-end application—to communicate with a Substrate node.

diff --git a/content/md/en/docs/examples/quickstart/index.html b/content/md/en/docs/examples/quickstart/index.html
@@ -20,36 +20,36 @@
       }
     </style>
   </head>
-  
+
   <body>
     <main role="main" class="container">
     <h1 style="font-family: sans-serif; font-weight: 500;">Display an account balance</h1>
       <p style="font-family: sans-serif;">Enter a development account address, then click <b>Get Balance</b>.</p>
-  
+
       <input type="text" size="58" id="account_address"/>
       <input type="button" onclick="GetBalance()" value="Get Balance">
       <p class="output">Balance: <span id="polkadot-balance">Not Connected</span></p>
     </main>
-  
+
     <script src="https://unpkg.com/@polkadot/util/bundle-polkadot-util.js"></script>
     <script src="https://unpkg.com/@polkadot/util-crypto/bundle-polkadot-util-crypto.js"></script>
     <script src="https://unpkg.com/@polkadot/types/bundle-polkadot-types.js"></script>
     <script src="https://unpkg.com/@polkadot/api/bundle-polkadot-api.js"></script>
-  
+
     <script>
       async function GetBalance() {
         const ADDR = '5Gb6Zfe8K8NSKrkFLCgqs8LUdk7wKweXM5pN296jVqDpdziR';
-  
+
         const { WsProvider, ApiPromise } = polkadotApi;
         const wsProvider = new WsProvider('ws://127.0.0.1:9944');
         const polkadot = await ApiPromise.create({ provider: wsProvider });
-  
+
         let polkadotBalance = document.getElementById("polkadot-balance");
         const x = document.getElementById("account_address").value;
         const { data: balance } = await polkadot.query.system.account(x);
-        
+
         polkadotBalance.innerText = balance.free;
-      }  
+      }
     </script>
   </body>
-  </html>
+  </html>
diff --git a/content/md/en/docs/learn/offchain-operations.md b/content/md/en/docs/learn/offchain-operations.md
@@ -5,12 +5,7 @@ keywords:
 ---
 
 <div class="warning">
-	<p>
-	<strong>⚠️ WARNING:</strong> This page contains potentially outdated information. Reading it might still be useful, yet we suggest taking it with a grain of salt.
-	</p>
-	<p>
-	 Please refer to the <a href="https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/reference_docs/frame_offchain_workers/index.html">`polkadot-sdk-docs` crate</a> for the most up-to-date documentation on this topic.
-	</p>
+	 Please refer to the <a href="https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/reference_docs/frame_offchain_workers/index.html">Rust Docs</a> for the most up-to-date documentation on this topic.
 </div>
 
 There are many use cases where you might want to query data from an offchain source or process data without using on-chain resources before updating the on-chain state.

diff --git a/content/md/en/docs/polkadot-sdk/index.md b/content/md/en/docs/polkadot-sdk/index.md
@@ -0,0 +1,39 @@
+---
+title: Polkadot SDK
+description:
+keywords:
+  - polkadot-sdk
+---
+
+
+## Substrate to Polkadot SDK
+
+In [May
+2023](https://forum.polkadot.network/t/psa-parity-is-currently-working-on-merging-the-polkadot-stack-repositories-into-one-single-repository/2883),
+Parity Technologies started moving 3 repositories of
+[`substrate`](https://github.com/paritytech/substrate),
+[`polkadot`](https://github.com/paritytech/polkadot), and
+[`cumulus`](https://github.com/paritytech/cumulus), formerly independent in development and
+branding, under one mew mono-repo called
+[`polkadot-sdk`](https://github.com/paritytech/polkadot-sdk). Consequently, the [runtimes of the
+Polkadot and Kusama relay chains, and their system chain](https://github.com/polkadot-fellows/runtimes) were moved to be maintained by the [Polkadot fellowship](polkadot-fellows.github.io/dashboard/).
+
+This transition gave birth to a new vision in which these tools are seen from lense of being part of `polkadot-sdk`, while still being independently useful.
+
+Most impacted in this transition is **Substrate**, and part of this impact is gradual deprecation of
+this website. The content in this website is no longer maintained, and will be gradually moved to a
+new home. Consider the [resources below](#alternative-resources) as primary sources of information.
+
+> You may still access the old content of this website in the navbar, but be aware of the fact that some content might not be up to date.
+
+Note that **this does not impact the development of Substrate as a framework**. Substrate, as a framework, is still being maintained with full steam as a part of polkadot-sdk, and retains its full ability to be used to build both [standalone blockchains](https://github.com/paritytech/polkadot-sdk-solochain-template), or [Polkadot powered parachains](https://github.com/paritytech/polkadot-sdk-parachain-template).
+
+## Alternative Resources
+
+Below, you can find a number of replacement resources to learn more about Polkadot SDK:
+
+- [Polkadot Wiki](https://wiki.polkadot.network/)
+- [Polkadot Developers](https://github.com/polkadot-developers/)
+- [Polkadot Blockchain Academy](https://academy.polkadot.network/)
+- [Polkadot Ecosystem Documentation by Papermoon](https://wiki.polkadot.network/)
+- [Polkadot SDK Rust Docs](https://wiki.polkadot.network/)
diff --git a/content/md/en/docs/reference/frame-macros.md b/content/md/en/docs/reference/frame-macros.md
@@ -4,7 +4,7 @@ description:
 keywords:
 ---
 <div class="warning">
-  <strong>⚠️ WARNING:</strong> This section contains outdated information. Please refer to the <a href="https://paritytech.github.io/polkadot-sdk/master/frame_support/attr.pallet.html">Rust docs</a> for the most up-to-date documentation on this topic.
+  Please refer to the <a href="https://paritytech.github.io/polkadot-sdk/master/frame_support/attr.pallet.html">Rust docs</a> for the most up-to-date documentation on this topic.
 </div>
 
 Substrate uses customized [Rust macros](https://doc.rust-lang.org/book/ch19-06-macros.html) to generate code and aggregate the logic from the pallets you implement for a runtime.

diff --git a/content/md/en/docs/reference/how-to-guides/offchain-workers/index.md b/content/md/en/docs/reference/how-to-guides/offchain-workers/index.md
@@ -5,12 +5,7 @@ keywords:
 ---
 
 <div class="warning">
-	<p>
-	<strong>⚠️ WARNING:</strong> This page contains potentially outdated information. Reading it might still be useful, yet we suggest taking it with a grain of salt.
-	</p>
-	<p>
-	 Please refer to the <a href="https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/reference_docs/frame_offchain_workers/index.html">`polkadot-sdk-docs` crate</a> for the most up-to-date documentation on this topic.
-	</p>
+	 Please refer to the <a href="https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/reference_docs/frame_offchain_workers/index.html">Rust Docs</a> for the most up-to-date documentation on this topic.
 </div>
 
 The _How-to_ guides in the _Offchain workers_ category illustrate common use cases for offchain operations.

diff --git a/...t/md/en/docs/reference/how-to-guides/offchain-workers/offchain-http-requests.md b/...t/md/en/docs/reference/how-to-guides/offchain-workers/offchain-http-requests.md
@@ -10,12 +10,7 @@ keywords:
 ---
 
 <div class="warning">
-	<p>
-	<strong>⚠️ WARNING:</strong> This page contains potentially outdated information. Reading it might still be useful, yet we suggest taking it with a grain of salt.
-	</p>
-	<p>
-	 Please refer to the <a href="https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/reference_docs/frame_offchain_workers/index.html">`polkadot-sdk-docs` crate</a> for the most up-to-date documentation on this topic.
-	</p>
+	 Please refer to the <a href="https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/reference_docs/frame_offchain_workers/index.html">Rust Docs</a> for the most up-to-date documentation on this topic.
 </div>
 
 Because most blockchains can't access data that's hosted on servers outside of their own network, they typically use external third-party services—**oracles**—to pull information in from or push information out to locations that are outside of the network.

diff --git a/content/md/en/docs/reference/how-to-guides/offchain-workers/offchain-indexing.md b/content/md/en/docs/reference/how-to-guides/offchain-workers/offchain-indexing.md
@@ -8,12 +8,7 @@ keywords:
 ---
 
 <div class="warning">
-	<p>
-	<strong>⚠️ WARNING:</strong> This page contains potentially outdated information. Reading it might still be useful, yet we suggest taking it with a grain of salt.
-	</p>
-	<p>
-	 Please refer to the <a href="https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/reference_docs/frame_offchain_workers/index.html">`polkadot-sdk-docs` crate</a> for the most up-to-date documentation on this topic.
-	</p>
+	 Please refer to the <a href="https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/reference_docs/frame_offchain_workers/index.html">Rust Docs</a> for the most up-to-date documentation on this topic.
 </div>
 
 This guide will step you through how to pass data from an extrinsic to an offchain worker without writing to storage.

diff --git a/...t/md/en/docs/reference/how-to-guides/offchain-workers/offchain-local-storage.md b/...t/md/en/docs/reference/how-to-guides/offchain-workers/offchain-local-storage.md
@@ -9,12 +9,7 @@ keywords:
 ---
 
 <div class="warning">
-	<p>
-	<strong>⚠️ WARNING:</strong> This page contains potentially outdated information. Reading it might still be useful, yet we suggest taking it with a grain of salt.
-	</p>
-	<p>
-	 Please refer to the <a href="https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/reference_docs/frame_offchain_workers/index.html">`polkadot-sdk-docs` crate</a> for the most up-to-date documentation on this topic.
-	</p>
+	 Please refer to the <a href="https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/reference_docs/frame_offchain_workers/index.html">Rust Docs</a> for the most up-to-date documentation on this topic.
 </div>
 
 This guide will teach you how to use an offchain worker to save retrieved data in local storage for future access.

diff --git a/content/md/en/docs/reference/how-to-guides/pallet-design/use-loose-coupling.md b/content/md/en/docs/reference/how-to-guides/pallet-design/use-loose-coupling.md
@@ -5,12 +5,7 @@ keywords:
 ---
 
 <div class="warning">
-	<p>
-	<strong>⚠️ WARNING:</strong> This page contains potentially outdated information. Reading it might still be useful, yet we suggest taking it with a grain of salt.
-	</p>
-	<p>
-	 Please refer to the <a href="https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/reference_docs/frame_pallet_coupling/index.html">`polkadot-sdk-docs` crate</a> for the most up-to-date documentation on this topic.
-	</p>
+	 Please refer to the <a href="https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/reference_docs/frame_pallet_coupling/index.html">Rust Docs</a> for the most up-to-date documentation on this topic.
 </div>
 
 This guide demonstrates how to reuse a function or type from one pallet in another pallet using a technique called **loose coupling**.

diff --git a/content/md/en/docs/reference/how-to-guides/pallet-design/use-tight-coupling.md b/content/md/en/docs/reference/how-to-guides/pallet-design/use-tight-coupling.md
@@ -5,12 +5,7 @@ keywords:
 ---
 
 <div class="warning">
-	<p>
-	<strong>⚠️ WARNING:</strong> This page contains potentially outdated information. Reading it might still be useful, yet we suggest taking it with a grain of salt.
-	</p>
-	<p>
-	 Please refer to the <a href="https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/reference_docs/frame_pallet_coupling/index.html">`polkadot-sdk-docs` crate</a> for the most up-to-date documentation on this topic.
-	</p>
+	 Please refer to the <a href="https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/reference_docs/frame_pallet_coupling/index.html">Rust Docs</a> for the most up-to-date documentation on this topic.
 </div>
 
 Tight coupling two pallets is a technique to write pallets that re-use types and methods from an existing pallet.