diff --git a/content/md/en/docs/tutorials/build-a-blockchain/add-trusted-nodes.md b/content/md/en/docs/tutorials/build-a-blockchain/add-trusted-nodes.md index 7044720e3..072e12355 100644 --- a/content/md/en/docs/tutorials/build-a-blockchain/add-trusted-nodes.md +++ b/content/md/en/docs/tutorials/build-a-blockchain/add-trusted-nodes.md @@ -7,6 +7,13 @@ keywords: - permission --- +
+

+ ⚠️ WARNING: This page contains potentially outdated information + and instructions. Reading it might still be useful, yet we suggest taking it with a grain of salt. When the new Polkadot developer documentation is published, the content on this page will be updated. Thanks for your patience! +

+
+ This tutorial illustrates how you can start a small, standalone blockchain network with an **authority set** of private **validators**. As you learned in [Blockchain basics](/learn/blockchain-basics/), all blockchains require the nodes in the network to agree on the state of data at any specific point in time and this agreement about the state is called **consensus**. diff --git a/content/md/en/docs/tutorials/build-a-blockchain/authorize-specific-nodes.md b/content/md/en/docs/tutorials/build-a-blockchain/authorize-specific-nodes.md index 415c63ec8..8f2829aa6 100644 --- a/content/md/en/docs/tutorials/build-a-blockchain/authorize-specific-nodes.md +++ b/content/md/en/docs/tutorials/build-a-blockchain/authorize-specific-nodes.md @@ -8,6 +8,13 @@ keywords: - restricted access --- +
+

+ ⚠️ WARNING: This page contains potentially outdated information + and instructions. Reading it might still be useful, yet we suggest taking it with a grain of salt. When the new Polkadot developer documentation is published, the content on this page will be updated. Thanks for your patience! +

+
+ In [Add trusted nodes](/tutorials/build-a-blockchain/add-trusted-nodes/), you saw how to build a simple network with a known set of validator nodes. That tutorial illustrated a simplified version of a **permissioned network**. In a permissioned network, only **authorized nodes** are allowed to perform specific network activities. diff --git a/content/md/en/docs/tutorials/build-a-blockchain/build-local-blockchain.md b/content/md/en/docs/tutorials/build-a-blockchain/build-local-blockchain.md index f5e7f5793..870f3421c 100644 --- a/content/md/en/docs/tutorials/build-a-blockchain/build-local-blockchain.md +++ b/content/md/en/docs/tutorials/build-a-blockchain/build-local-blockchain.md @@ -4,6 +4,15 @@ description: Compile, launch, and interact with a single local blockchain node i keywords: --- +
+

+ ⚠️ WARNING: This page contains potentially outdated information and instructions. New Polkadot developer documentation is in the works! +

+

+ Meanwhile, please refer to the instructions on `minimal-template` and `solochain-template` repositories for the latest documentation and working code for this tutorial. +

+
+ As you learned in [Blockchain basics](/learn/blockchain-basics/), a blockchain consists of decentralized computers—called nodes—to form a network. Substrate provides a flexible, open, and extensible development environment that allows you to design and build fully-customized blockchain nodes to suit your application or business model needs. diff --git a/content/md/en/docs/tutorials/build-a-blockchain/index.md b/content/md/en/docs/tutorials/build-a-blockchain/index.md index bb7c0ba72..0d64933b7 100644 --- a/content/md/en/docs/tutorials/build-a-blockchain/index.md +++ b/content/md/en/docs/tutorials/build-a-blockchain/index.md @@ -10,6 +10,14 @@ keywords: - generate keys --- +
+

+ ⚠️ WARNING: This page contains a list of tutorials with potentially outdated information + and instructions. When the new Polkadot developer documentation is published, the content and + links on this page will be updated. Thanks for your patience! +

+
+ The **Build a blockchain** tutorials illustrate the basics for working with Substrate-based blockchain nodes, including how to make nodes communicate with each other in a network of peers and how to collect metrics about node operations. In general, you should complete the tutorials in the order listed because they lay the foundation for trying later tutorials or performing more complex tasks. Later tutorials reinforce or expand on the basic topics you learn in the Get started tutorials. diff --git a/content/md/en/docs/tutorials/build-a-blockchain/monitor-node-metrics.md b/content/md/en/docs/tutorials/build-a-blockchain/monitor-node-metrics.md index 16b4d1fca..92de80ef8 100644 --- a/content/md/en/docs/tutorials/build-a-blockchain/monitor-node-metrics.md +++ b/content/md/en/docs/tutorials/build-a-blockchain/monitor-node-metrics.md @@ -7,6 +7,13 @@ keywords: - node operations --- +
+

+ ⚠️ WARNING: This page contains potentially outdated information + and instructions. Reading it might still be useful, yet we suggest taking it with a grain of salt. When the new Polkadot developer documentation is published, the content on this page will be updated. Thanks for your patience! +

+
+ Substrate exposes metrics about the operation of your network. For example, you can collect information about how many peers your node is connected to, how much memory your node is using, and the number of blocks being produced. To capture and visualize the metrics that Substrate nodes expose, you can configure and use tools like [Prometheus](https://prometheus.io/) and [Grafana](https://grafana.com/). diff --git a/content/md/en/docs/tutorials/build-a-blockchain/simulate-network.md b/content/md/en/docs/tutorials/build-a-blockchain/simulate-network.md index 15c835992..c2e033f66 100644 --- a/content/md/en/docs/tutorials/build-a-blockchain/simulate-network.md +++ b/content/md/en/docs/tutorials/build-a-blockchain/simulate-network.md @@ -4,6 +4,13 @@ description: Start a private blockchain network using predefined accounts as aut keywords: --- +
+

+ ⚠️ WARNING: This page contains potentially outdated information + and instructions. Reading it might still be useful, yet we suggest taking it with a grain of salt. When the new Polkadot developer documentation is published, the content on this page will be updated. Thanks for your patience! +

+
+ This tutorial provides a basic introduction to how you can start a private blockchain network with an **authority set** of private **validators**. The Substrate node template uses an authority consensus model that limits block production to a rotating list of authorized accounts. diff --git a/content/md/en/docs/tutorials/build-a-blockchain/upgrade-a-running-network.md b/content/md/en/docs/tutorials/build-a-blockchain/upgrade-a-running-network.md index 1b452c752..c3d3b6eac 100644 --- a/content/md/en/docs/tutorials/build-a-blockchain/upgrade-a-running-network.md +++ b/content/md/en/docs/tutorials/build-a-blockchain/upgrade-a-running-network.md @@ -6,6 +6,13 @@ keywords: - runtime upgrade --- +
+

+ ⚠️ WARNING: This page contains potentially outdated information + and instructions. Reading it might still be useful, yet we suggest taking it with a grain of salt. When the new Polkadot developer documentation is published, the content on this page will be updated. Thanks for your patience! +

+
+ Unlike many blockchains, the Substrate development framework supports **forkless upgrades** to the runtime that is the core of the blockchain. Most blockchain projects require a [hard fork](/reference/glossary/#fork) of the code base to support ongoing development of new features or enhancements to existing features. With Substrate, you can deploy enhanced runtime capabilities—including breaking changes—without a hard fork. diff --git a/content/md/en/docs/tutorials/build-a-parachain/acquire-a-testnet-slot.md b/content/md/en/docs/tutorials/build-a-parachain/acquire-a-testnet-slot.md index b4148bdc9..18336e38b 100644 --- a/content/md/en/docs/tutorials/build-a-parachain/acquire-a-testnet-slot.md +++ b/content/md/en/docs/tutorials/build-a-parachain/acquire-a-testnet-slot.md @@ -8,6 +8,13 @@ keywords: - relay chain --- +
+

+ ⚠️ WARNING: This page contains potentially outdated information + and instructions. Reading it might still be useful, yet we suggest taking it with a grain of salt. When the new Polkadot developer documentation is published, the content on this page will be updated. Thanks for your patience! +

+
+ This tutorial demonstrates how you can deploy a parachain on a public test network, such as the [Rococo](https://wiki.polkadot.network/docs/build-pdk#rococo-testnet) test network. Public test networks have a higher bar to entry than a private network, but represent an important step in preparing a parachain project to move into a production network. diff --git a/content/md/en/docs/tutorials/build-a-parachain/connect-a-local-parachain.md b/content/md/en/docs/tutorials/build-a-parachain/connect-a-local-parachain.md index d777a0d5d..e612cf678 100644 --- a/content/md/en/docs/tutorials/build-a-parachain/connect-a-local-parachain.md +++ b/content/md/en/docs/tutorials/build-a-parachain/connect-a-local-parachain.md @@ -9,6 +9,13 @@ keywords: - chain specification --- +
+

+ ⚠️ WARNING: This page contains potentially outdated information + and instructions. Reading it might still be useful, yet we suggest taking it with a grain of salt. When the new Polkadot developer documentation is published, the content on this page will be updated. Thanks for your patience! +

+
+ This tutorial illustrates how to reserve a parachain identifier with a local relay chain and how to connect a local parachain to that relay chain. ## Tutorial objectives diff --git a/content/md/en/docs/tutorials/build-a-parachain/index.md b/content/md/en/docs/tutorials/build-a-parachain/index.md index e76331858..276888af7 100644 --- a/content/md/en/docs/tutorials/build-a-parachain/index.md +++ b/content/md/en/docs/tutorials/build-a-parachain/index.md @@ -9,6 +9,14 @@ keywords: - Polkadot --- +
+

+ ⚠️ WARNING: This page contains a list of tutorials with potentially outdated information + and instructions. When the new Polkadot developer documentation is published, the content and + links on this page will be updated. Thanks for your patience! +

+
+ The **Build a parachain** tutorials delve into more advanced topics for moving beyond solo chain development, including how to connect your chain to other chains. - [Prepare a local relay chain](/tutorials/build-a-parachain/prepare-a-local-relay-chain/) helps you prepare a local relay chain to use in testing a local parachain. diff --git a/content/md/en/docs/tutorials/build-a-parachain/open-message-passing-channels.md b/content/md/en/docs/tutorials/build-a-parachain/open-message-passing-channels.md index 168903967..dbf430243 100644 --- a/content/md/en/docs/tutorials/build-a-parachain/open-message-passing-channels.md +++ b/content/md/en/docs/tutorials/build-a-parachain/open-message-passing-channels.md @@ -9,6 +9,13 @@ keywords: - parachain --- +
+

+ ⚠️ WARNING: This page contains potentially outdated information + and instructions. Reading it might still be useful, yet we suggest taking it with a grain of salt. When the new Polkadot developer documentation is published, the content on this page will be updated. Thanks for your patience! +

+
+ In the Polkadot ecosystem, chains can communicate with each other by passing messages over secure channels. There are three main communication channels: diff --git a/content/md/en/docs/tutorials/build-a-parachain/prepare-a-local-relay-chain.md b/content/md/en/docs/tutorials/build-a-parachain/prepare-a-local-relay-chain.md index 2b1fdb6c2..fec8e2072 100644 --- a/content/md/en/docs/tutorials/build-a-parachain/prepare-a-local-relay-chain.md +++ b/content/md/en/docs/tutorials/build-a-parachain/prepare-a-local-relay-chain.md @@ -16,6 +16,13 @@ keywords: - local --- +
+

+ ⚠️ WARNING: This page contains potentially outdated information + and instructions. Reading it might still be useful, yet we suggest taking it with a grain of salt. When the new Polkadot developer documentation is published, the content on this page will be updated. Thanks for your patience! +

+
+ This tutorial illustrates how to configure a local relay chain. The local relay chain is required to set up a local testing environment that a test parachain node can connect to. diff --git a/content/md/en/docs/tutorials/build-a-parachain/transfer-assets-with-xcm.md b/content/md/en/docs/tutorials/build-a-parachain/transfer-assets-with-xcm.md index 38d9cfe62..70af68ebc 100644 --- a/content/md/en/docs/tutorials/build-a-parachain/transfer-assets-with-xcm.md +++ b/content/md/en/docs/tutorials/build-a-parachain/transfer-assets-with-xcm.md @@ -9,6 +9,13 @@ keywords: - cross consensus --- +
+

+ ⚠️ WARNING: This page contains potentially outdated information + and instructions. Reading it might still be useful, yet we suggest taking it with a grain of salt. When the new Polkadot developer documentation is published, the content on this page will be updated. Thanks for your patience! +

+
+ In [Open message passing channels](/tutorials/build-a-parachain/open-message-passing-channels), you saw how to open a two-way communication channel between chains by sending messages to the relay chain. You can use a similar strategy to send messages that allow a local chain to manage an account on a remote chain. In this tutorial, parachain B transfers assets into the sovereign account on the relay chain for parachain A. diff --git a/content/md/en/docs/tutorials/build-application-logic/add-a-pallet.md b/content/md/en/docs/tutorials/build-application-logic/add-a-pallet.md index a920de241..ef29303b3 100644 --- a/content/md/en/docs/tutorials/build-application-logic/add-a-pallet.md +++ b/content/md/en/docs/tutorials/build-application-logic/add-a-pallet.md @@ -10,6 +10,13 @@ keywords: - configuration --- +
+

+ ⚠️ WARNING: This page contains potentially outdated information + and instructions. Reading it might still be useful, yet we suggest taking it with a grain of salt. When the new Polkadot developer documentation is published, the content on this page will be updated. Thanks for your patience! +

+
+ As you saw in [Build a local blockchain](/tutorials/build-a-blockchain/build-local-blockchain/), the [Substrate node template](https://github.com/substrate-developer-hub/substrate-node-template) provides a working **runtime** that includes some default FRAME development modules—**pallets**—to get you started building a custom blockchain. This tutorial introduces the basic steps for adding a new pallet to the runtime for the node template. diff --git a/content/md/en/docs/tutorials/build-application-logic/add-offchain-workers.md b/content/md/en/docs/tutorials/build-application-logic/add-offchain-workers.md index a7b1ced2c..8b23bf7ad 100644 --- a/content/md/en/docs/tutorials/build-application-logic/add-offchain-workers.md +++ b/content/md/en/docs/tutorials/build-application-logic/add-offchain-workers.md @@ -11,6 +11,13 @@ keywords: - signed payload --- +
+

+ ⚠️ WARNING: This page contains potentially outdated information + and instructions. When the new [Polkadot developer documentation](https://forum.polkadot.network/t/decentralized-futures-ecosystem-devrel-team-for-polkadot-by-papermoon/5811) is published, the content on this page will be updated. Thanks for your patience! +

+
+

⚠️ WARNING: This page contains potentially outdated information. Reading it might still be useful, yet we suggest taking it with a grain of salt. diff --git a/content/md/en/docs/tutorials/build-application-logic/index.md b/content/md/en/docs/tutorials/build-application-logic/index.md index 478359fec..16146532a 100644 --- a/content/md/en/docs/tutorials/build-application-logic/index.md +++ b/content/md/en/docs/tutorials/build-application-logic/index.md @@ -4,6 +4,14 @@ description: Demonstrates how you can add pallets to customize the Substrate run keywords: --- +

+

+ ⚠️ WARNING: This page contains a list of tutorials with potentially outdated information + and instructions. When the new Polkadot developer documentation is published, the content and + links on this page will be updated. Thanks for your patience! +

+
+ The **Build application logic** tutorials focus on how you can customize the runtime using pallets, including how to add simple and complex pallets to the runtime and how to use pallets in combination with smart contracts. You'll learn how to: diff --git a/content/md/en/docs/tutorials/build-application-logic/publish-custom-pallets.md b/content/md/en/docs/tutorials/build-application-logic/publish-custom-pallets.md index a7ed6ed09..bb99707e4 100644 --- a/content/md/en/docs/tutorials/build-application-logic/publish-custom-pallets.md +++ b/content/md/en/docs/tutorials/build-application-logic/publish-custom-pallets.md @@ -4,6 +4,13 @@ description: Suggests how you can publish custom pallets and crates to make them keywords: --- +
+

+ ⚠️ WARNING: This page contains potentially outdated information + and instructions. Reading it might still be useful, yet we suggest taking it with a grain of salt. When the new Polkadot developer documentation is published, the content on this page will be updated. Thanks for your patience! +

+
+ As a blockchain builder or parachain developer, you have access to a large library of specialized pallets that you can assemble to customize your runtime to suite your specific project goals. To get a general sense of the number of the predefined pallets currently available, explore the Substrate [FRAME repository](https://github.com/paritytech/polkadot-sdk/tree/master/substrate/frame). The selection of pallets available and the use cases they address is continuously evolving, including with many contributions from community members. diff --git a/content/md/en/docs/tutorials/build-application-logic/specify-the-origin-for-a-call.md b/content/md/en/docs/tutorials/build-application-logic/specify-the-origin-for-a-call.md index d08567319..ce98993b1 100644 --- a/content/md/en/docs/tutorials/build-application-logic/specify-the-origin-for-a-call.md +++ b/content/md/en/docs/tutorials/build-application-logic/specify-the-origin-for-a-call.md @@ -7,6 +7,13 @@ keywords: - origins --- +
+

+ ⚠️ WARNING: This page contains potentially outdated information + and instructions. Reading it might still be useful, yet we suggest taking it with a grain of salt. When the new Polkadot developer documentation is published, the content on this page will be updated. Thanks for your patience! +

+
+ In [Add a pallet to the runtime](/tutorials/build-application-logic/add-a-pallet), you added functions from `pallet_nicks` to the [Substrate node template](https://github.com/substrate-developer-hub/substrate-node-template) runtime. The Nicks pallet allows blockchain users to pay a deposit to reserve a nickname for an account they control. diff --git a/content/md/en/docs/tutorials/build-application-logic/use-macros-in-a-custom-pallet.md b/content/md/en/docs/tutorials/build-application-logic/use-macros-in-a-custom-pallet.md index 197db12f0..10b840535 100644 --- a/content/md/en/docs/tutorials/build-application-logic/use-macros-in-a-custom-pallet.md +++ b/content/md/en/docs/tutorials/build-application-logic/use-macros-in-a-custom-pallet.md @@ -3,6 +3,12 @@ title: Use macros in a custom pallet description: Create a custom pallet for a Substrate runtime using a skeleton of FRAME macros. keywords: --- +
+

+ ⚠️ WARNING: This page contains potentially outdated information + and instructions. Reading it might still be useful, yet we suggest taking it with a grain of salt. When the new Polkadot developer documentation is published, the content on this page will be updated. Thanks for your patience! +

+
This tutorial illustrates how to create a custom pallet for a Substrate runtime using **macros** that are part of the [FRAME](/reference/frame-macros/) development environment. diff --git a/content/md/en/docs/tutorials/collectibles-workshop/index.md b/content/md/en/docs/tutorials/collectibles-workshop/index.md index 7a60e6357..d75710394 100644 --- a/content/md/en/docs/tutorials/collectibles-workshop/index.md +++ b/content/md/en/docs/tutorials/collectibles-workshop/index.md @@ -6,6 +6,14 @@ keywords: - runtime --- +
+

+ ⚠️ WARNING: This page contains a list of tutorials with potentially outdated information + and instructions. When the new Polkadot developer documentation is published, the content and + links on this page will be updated. Thanks for your patience! +

+
+ The Substrate Developer Hub provides self-paced workshops with content and coding challenges to help you learn about building blockchains and decentralized applications using Substrate, Rust, and related tools. As you progress through the workshops, you’ll learn basic concepts, see examples of what to do, and test your knowledge by converting what you’ve learned into working code. diff --git a/content/md/en/docs/tutorials/index.md b/content/md/en/docs/tutorials/index.md index 348f25ea4..fb0d22f23 100644 --- a/content/md/en/docs/tutorials/index.md +++ b/content/md/en/docs/tutorials/index.md @@ -4,6 +4,14 @@ description: keywords: --- +
+

+ ⚠️ WARNING: This page contains a list of tutorials with potentially outdated information + and instructions. When the new Polkadot developer documentation is published, the content and + links on this page will be updated. Thanks for your patience! +

+
+ If you are someone who likes to learn by doing, the Substrate tutorials are a great place to start your journey. Tutorials don't provide much background about _why_ you are performing certain steps or explain the coding details. Instead, the tutorials give you hands-on experience performing the tasks essential to building your own blockchain and focus on ensuring a successful result. diff --git a/content/md/en/docs/tutorials/integrate-with-tools/index.md b/content/md/en/docs/tutorials/integrate-with-tools/index.md index 71f1d020c..c5fa2b671 100644 --- a/content/md/en/docs/tutorials/integrate-with-tools/index.md +++ b/content/md/en/docs/tutorials/integrate-with-tools/index.md @@ -4,6 +4,14 @@ description: Demonstrates use cases for tools that enable you to connect to and keywords: --- +
+

+ ⚠️ WARNING: This page contains a list of tutorials with potentially outdated information + and instructions. When the new [Polkadot developer documentation is published, the content and + links on this page will be updated. Thanks for your patience! +

+
+ The **Integrate with tools** tutorials highlight tools and node extensions that enable you to deploy nodes that can integrate with other systems and how to use additional ecosystem tools that allow you to access, synchronize, and interact with information your own or other blockchains. - [Integrate a light client node](/tutorials/integrate-with-tools/integrate-a-light-client-node/) describes how you can use the Substrate Connect light client node to synchronize and interact with a Substrate chain from a browser. diff --git a/content/md/en/docs/tutorials/smart-contracts/index.md b/content/md/en/docs/tutorials/smart-contracts/index.md index 5fd2b955c..be8cad44f 100644 --- a/content/md/en/docs/tutorials/smart-contracts/index.md +++ b/content/md/en/docs/tutorials/smart-contracts/index.md @@ -5,6 +5,14 @@ keywords: - smart contracts --- +
+

+ ⚠️ WARNING: This page contains a list of tutorials with potentially outdated information + and instructions. When the new Polkadot developer documentation is published, the content and + links on this page will be updated. Thanks for your patience! +

+
+ The **Develop smart contracts** tutorials guide you through how you can use [the ink! programming language](https://use.ink) to build smart contracts that run on a Substrate-based blockchain. The tutorials in this section use a preconfigured