Skip to content

Commit 4055031

Browse files
committed
Add outdated content banners to Tutorial docs
1 parent 1c9dc87 commit 4055031

23 files changed

+169
-0
lines changed

content/md/en/docs/tutorials/build-a-blockchain/add-trusted-nodes.md

+7
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,13 @@ keywords:
77
- permission
88
---
99

10+
<div class="warning">
11+
<p>
12+
<strong>⚠️ WARNING:</strong> This page contains potentially outdated information
13+
and instructions. Reading it might still be useful, yet we suggest taking it with a grain of salt. 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!
14+
</p>
15+
</div>
16+
1017
This tutorial illustrates how you can start a small, standalone blockchain network with an **authority set** of private **validators**.
1118

1219
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**.

content/md/en/docs/tutorials/build-a-blockchain/authorize-specific-nodes.md

+7
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,13 @@ keywords:
88
- restricted access
99
---
1010

11+
<div class="warning">
12+
<p>
13+
<strong>⚠️ WARNING:</strong> This page contains potentially outdated information
14+
and instructions. Reading it might still be useful, yet we suggest taking it with a grain of salt. 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!
15+
</p>
16+
</div>
17+
1118
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.
1219
That tutorial illustrated a simplified version of a **permissioned network**.
1320
In a permissioned network, only **authorized nodes** are allowed to perform specific network activities.

content/md/en/docs/tutorials/build-a-blockchain/build-local-blockchain.md

+9
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,15 @@ description: Compile, launch, and interact with a single local blockchain node i
44
keywords:
55
---
66

7+
<div class="warning">
8+
<p>
9+
<strong>⚠️ WARNING:</strong> This page contains potentially outdated information and instructions. New Polkadot developer documentation is in the works!
10+
</p>
11+
<p>
12+
Meanwhile, please refer to the instructions on <a href="https://github.com/paritytech/polkadot-sdk-minimal-template">`minimal-template`</a> and <a href="https://github.com/paritytech/polkadot-sdk-solochain-template">`solochain-template` repositories</a> for the latest documentation and working code for this tutorial.
13+
</p>
14+
</div>
15+
716
As you learned in [Blockchain basics](/learn/blockchain-basics/), a blockchain consists of decentralized computers—called nodes—to form a network.
817

918
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.

content/md/en/docs/tutorials/build-a-blockchain/index.md

+8
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,14 @@ keywords:
1010
- generate keys
1111
---
1212

13+
<div class="warning">
14+
<p>
15+
<strong>⚠️ WARNING:</strong> This page contains a list of tutorials with potentially outdated information
16+
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 and
17+
links on this page will be updated. Thanks for your patience!
18+
</p>
19+
</div>
20+
1321
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.
1422
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.
1523
Later tutorials reinforce or expand on the basic topics you learn in the Get started tutorials.

content/md/en/docs/tutorials/build-a-blockchain/monitor-node-metrics.md

+7
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,13 @@ keywords:
77
- node operations
88
---
99

10+
<div class="warning">
11+
<p>
12+
<strong>⚠️ WARNING:</strong> This page contains potentially outdated information
13+
and instructions. Reading it might still be useful, yet we suggest taking it with a grain of salt. 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!
14+
</p>
15+
</div>
16+
1017
Substrate exposes metrics about the operation of your network.
1118
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.
1219
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/).

content/md/en/docs/tutorials/build-a-blockchain/simulate-network.md

+7
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,13 @@ description: Start a private blockchain network using predefined accounts as aut
44
keywords:
55
---
66

7+
<div class="warning">
8+
<p>
9+
<strong>⚠️ WARNING:</strong> This page contains potentially outdated information
10+
and instructions. Reading it might still be useful, yet we suggest taking it with a grain of salt. 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!
11+
</p>
12+
</div>
13+
714
This tutorial provides a basic introduction to how you can start a private blockchain network with an **authority set** of private **validators**.
815

916
The Substrate node template uses an authority consensus model that limits block production to a rotating list of authorized accounts.

content/md/en/docs/tutorials/build-a-blockchain/upgrade-a-running-network.md

+7
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,13 @@ keywords:
66
- runtime upgrade
77
---
88

9+
<div class="warning">
10+
<p>
11+
<strong>⚠️ WARNING:</strong> This page contains potentially outdated information
12+
and instructions. Reading it might still be useful, yet we suggest taking it with a grain of salt. 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!
13+
</p>
14+
</div>
15+
916
Unlike many blockchains, the Substrate development framework supports **forkless upgrades** to the runtime that is the core of the blockchain.
1017
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.
1118
With Substrate, you can deploy enhanced runtime capabilities—including breaking changes—without a hard fork.

content/md/en/docs/tutorials/build-a-parachain/acquire-a-testnet-slot.md

+7
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,13 @@ keywords:
88
- relay chain
99
---
1010

11+
<div class="warning">
12+
<p>
13+
<strong>⚠️ WARNING:</strong> This page contains potentially outdated information
14+
and instructions. Reading it might still be useful, yet we suggest taking it with a grain of salt. 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!
15+
</p>
16+
</div>
17+
1118
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.
1219
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.
1320

content/md/en/docs/tutorials/build-a-parachain/connect-a-local-parachain.md

+7
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,13 @@ keywords:
99
- chain specification
1010
---
1111

12+
<div class="warning">
13+
<p>
14+
<strong>⚠️ WARNING:</strong> This page contains potentially outdated information
15+
and instructions. Reading it might still be useful, yet we suggest taking it with a grain of salt. 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!
16+
</p>
17+
</div>
18+
1219
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.
1320

1421
## Tutorial objectives

content/md/en/docs/tutorials/build-a-parachain/index.md

+8
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,14 @@ keywords:
99
- Polkadot
1010
---
1111

12+
<div class="warning">
13+
<p>
14+
<strong>⚠️ WARNING:</strong> This page contains a list of tutorials with potentially outdated information
15+
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 and
16+
links on this page will be updated. Thanks for your patience!
17+
</p>
18+
</div>
19+
1220
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.
1321

1422
- [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.

content/md/en/docs/tutorials/build-a-parachain/open-message-passing-channels.md

+7
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,13 @@ keywords:
99
- parachain
1010
---
1111

12+
<div class="warning">
13+
<p>
14+
<strong>⚠️ WARNING:</strong> This page contains potentially outdated information
15+
and instructions. Reading it might still be useful, yet we suggest taking it with a grain of salt. 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!
16+
</p>
17+
</div>
18+
1219
In the Polkadot ecosystem, chains can communicate with each other by passing messages over secure channels.
1320
There are three main communication channels:
1421

content/md/en/docs/tutorials/build-a-parachain/prepare-a-local-relay-chain.md

+7
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,13 @@ keywords:
1616
- local
1717
---
1818

19+
<div class="warning">
20+
<p>
21+
<strong>⚠️ WARNING:</strong> This page contains potentially outdated information
22+
and instructions. Reading it might still be useful, yet we suggest taking it with a grain of salt. 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!
23+
</p>
24+
</div>
25+
1926
This tutorial illustrates how to configure a local relay chain.
2027
The local relay chain is required to set up a local testing environment that a test parachain node can connect to.
2128

content/md/en/docs/tutorials/build-a-parachain/transfer-assets-with-xcm.md

+7
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,13 @@ keywords:
99
- cross consensus
1010
---
1111

12+
<div class="warning">
13+
<p>
14+
<strong>⚠️ WARNING:</strong> This page contains potentially outdated information
15+
and instructions. Reading it might still be useful, yet we suggest taking it with a grain of salt. 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!
16+
</p>
17+
</div>
18+
1219
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.
1320
You can use a similar strategy to send messages that allow a local chain to manage an account on a remote chain.
1421
In this tutorial, parachain B transfers assets into the sovereign account on the relay chain for parachain A.

content/md/en/docs/tutorials/build-application-logic/add-a-pallet.md

+7
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,13 @@ keywords:
1010
- configuration
1111
---
1212

13+
<div class="warning">
14+
<p>
15+
<strong>⚠️ WARNING:</strong> This page contains potentially outdated information
16+
and instructions. Reading it might still be useful, yet we suggest taking it with a grain of salt. 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!
17+
</p>
18+
</div>
19+
1320
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.
1421

1522
This tutorial introduces the basic steps for adding a new pallet to the runtime for the node template.

content/md/en/docs/tutorials/build-application-logic/add-offchain-workers.md

+7
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,13 @@ keywords:
1111
- signed payload
1212
---
1313

14+
<div class="warning">
15+
<p>
16+
<strong>⚠️ WARNING:</strong> This page contains potentially outdated information
17+
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!
18+
</p>
19+
</div>
20+
1421
<div class="warning">
1522
<p>
1623
<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.

content/md/en/docs/tutorials/build-application-logic/index.md

+8
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,14 @@ description: Demonstrates how you can add pallets to customize the Substrate run
44
keywords:
55
---
66

7+
<div class="warning">
8+
<p>
9+
<strong>⚠️ WARNING:</strong> This page contains a list of tutorials with potentially outdated information
10+
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 and
11+
links on this page will be updated. Thanks for your patience!
12+
</p>
13+
</div>
14+
715
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.
816
You'll learn how to:
917

content/md/en/docs/tutorials/build-application-logic/publish-custom-pallets.md

+7
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,13 @@ description: Suggests how you can publish custom pallets and crates to make them
44
keywords:
55
---
66

7+
<div class="warning">
8+
<p>
9+
<strong>⚠️ WARNING:</strong> This page contains potentially outdated information
10+
and instructions. Reading it might still be useful, yet we suggest taking it with a grain of salt. 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!
11+
</p>
12+
</div>
13+
714
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.
815
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).
916
The selection of pallets available and the use cases they address is continuously evolving, including with many contributions from community members.

content/md/en/docs/tutorials/build-application-logic/specify-the-origin-for-a-call.md

+7
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,13 @@ keywords:
77
- origins
88
---
99

10+
<div class="warning">
11+
<p>
12+
<strong>⚠️ WARNING:</strong> This page contains potentially outdated information
13+
and instructions. Reading it might still be useful, yet we suggest taking it with a grain of salt. 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!
14+
</p>
15+
</div>
16+
1017
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.
1118

1219
The Nicks pallet allows blockchain users to pay a deposit to reserve a nickname for an account they control.

content/md/en/docs/tutorials/build-application-logic/use-macros-in-a-custom-pallet.md

+6
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,12 @@ title: Use macros in a custom pallet
33
description: Create a custom pallet for a Substrate runtime using a skeleton of FRAME macros.
44
keywords:
55
---
6+
<div class="warning">
7+
<p>
8+
<strong>⚠️ WARNING:</strong> This page contains potentially outdated information
9+
and instructions. Reading it might still be useful, yet we suggest taking it with a grain of salt. 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!
10+
</p>
11+
</div>
612

713
This tutorial illustrates how to create a custom pallet for a Substrate
814
runtime using **macros** that are part of the [FRAME](/reference/frame-macros/) development environment.

content/md/en/docs/tutorials/collectibles-workshop/index.md

+8
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,14 @@ keywords:
66
- runtime
77
---
88

9+
<div class="warning">
10+
<p>
11+
<strong>⚠️ WARNING:</strong> This page contains a list of tutorials with potentially outdated information
12+
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 and
13+
links on this page will be updated. Thanks for your patience!
14+
</p>
15+
</div>
16+
917
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.
1018

1119
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.

content/md/en/docs/tutorials/index.md

+8
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,14 @@ description:
44
keywords:
55
---
66

7+
<div class="warning">
8+
<p>
9+
<strong>⚠️ WARNING:</strong> This page contains a list of tutorials with potentially outdated information
10+
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 and
11+
links on this page will be updated. Thanks for your patience!
12+
</p>
13+
</div>
14+
715
If you are someone who likes to learn by doing, the Substrate tutorials are a great place to start your journey.
816
Tutorials don't provide much background about _why_ you are performing certain steps or explain the coding details.
917
Instead, the tutorials give you hands-on experience performing the tasks essential to building your own blockchain and focus on ensuring a successful result.

content/md/en/docs/tutorials/integrate-with-tools/index.md

+8
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,14 @@ description: Demonstrates use cases for tools that enable you to connect to and
44
keywords:
55
---
66

7+
<div class="warning">
8+
<p>
9+
<strong>⚠️ WARNING:</strong> This page contains a list of tutorials with potentially outdated information
10+
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 and
11+
links on this page will be updated. Thanks for your patience!
12+
</p>
13+
</div>
14+
715
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.
816

917
- [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.

content/md/en/docs/tutorials/smart-contracts/index.md

+8
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,14 @@ keywords:
55
- smart contracts
66
---
77

8+
<div class="warning">
9+
<p>
10+
<strong>⚠️ WARNING:</strong> This page contains a list of tutorials with potentially outdated information
11+
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 and
12+
links on this page will be updated. Thanks for your patience!
13+
</p>
14+
</div>
15+
816
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.
917

1018
The tutorials in this section use a preconfigured

0 commit comments

Comments
 (0)