Add Paseo testnet (#5595)

* added info * technical fellowship * Update docs/general/glossary.md Co-authored-by: Radha <[email protected]> * Update docs/general/glossary.md Co-authored-by: Radha <[email protected]> * added link --------- Co-authored-by: Radha <[email protected]>
w3f · Feb 14, 2024 · 513f4c1 · 513f4c1
1 parent 79e2b6e
commit 513f4c1
Show file tree

Hide file tree

Showing 2 changed files with 33 additions and 3 deletions.
diff --git a/docs/general/glossary.md b/docs/general/glossary.md
@@ -240,7 +240,7 @@ from the outside world, i.e. they are not part of the system itself. Extrinsics
 "[inherents](#inherent)" and "[transactions](#transaction)". For more technical details see the
 [polkadot spec](https://spec.polkadot.network/#id-extrinsics)
 
-## Fellowship
+## Technical Fellowship
 
 A mostly self-governing expert body with a primary goal of representing humans who embody and
 contain the technical knowledge base of the Kusama and/or Polkadot networks and protocols.
@@ -521,6 +521,14 @@ will have to use a bridge. Previously known as the
 The previous name for the {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }}
 [Host](#polkadot-host).
 
+## Paseo
+
+Paseo [testnet](#testnet) provisions testing on Polkadot's "production" runtime, which means less
+chance of feature/code mismatch when developing parachain apps. Specifically, after the
+[Polkadot Technical fellowship](#technical-fellowship) proposes a runtime upgrade for Polkadot, this
+testnet is updated, giving a period where the testnet will be ahead of Polkadot to allow for
+testing.
+
 ## Preimage
 
 The on-chain proposals do not require the entire image of extrinsics and data (for instance the WASM
@@ -811,6 +819,13 @@ the cost of the transactions (referred to as [extrinsics](#extrinsic)) are deter
 execution. Checkout this section of the Substrate docs covering
 [transaction weights and fees](https://docs.substrate.io/build/tx-weights-fees/).
 
+## Westend
+
+The [testnet](#testnet) is set aside for testing the Polkadot Relay Chain. Contrary to the
+[Paseo testnet](#paseo), the Westend testnet is used by the core developers to iterate on
+protocol-level features like [asynchronous backing](../learn/learn-async-backing.md), etc, that are
+not relevant for parachain developers.
+
 ## Witness
 
 Cryptographic proof statements of data validity.

diff --git a/docs/learn/learn-DOT.md b/docs/learn/learn-DOT.md
@@ -140,8 +140,23 @@ All the tokens under active issuance are can be used to participate in the gover
 ## Obtaining Testnet Tokens
 
 DOT are required to make transactions on the Polkadot network. Tokens on Polkadot's Testnets like
-Westend and Rococo do not have any value besides allowing you to experiment with the features on the
-network.
+Paseo, Westend and Rococo do not have any value besides allowing you to experiment with the features
+on the network.
+
+### Getting Tokens on the Paseo Testnet
+
+The Paseo testnet mirrors the Polkadot runtime and it is maintained by the community. To get Paseo
+tokens (PAS) you can use the web-based
+[Paseo faucet](https://paritytech.github.io/polkadot-testnet-faucet/paseo). The PAS tokens has the
+same Planck conversion as Polkadot.
+
+| Unit            | Decimal Places | Conversion to Planck   | Conversion to PAS |
+| --------------- | -------------- | ---------------------- | ----------------- |
+| Planck          | 0              | 1 Planck               | 0.0000000001 PAS  |
+| Microdot (uPAS) | 4              | 10<sup>4</sup> Planck  | 0.0000010000 PAS  |
+| Millidot (mPAS) | 7              | 10<sup>7</sup> Planck  | 0.0010000000 PAS  |
+| Dot (PAS)       | 10             | 10<sup>10</sup> Planck | 1.0000000000 PAS  |
+| Million (MPAS)  | 16             | 10<sup>16</sup> Planck | 1,000,000.00 PAS  |
 
 ### Getting Tokens on the Westend Testnet