Move content nominator guides

docs/general/kusama/kusama-getting-started.md

@@ -212,5 +212,5 @@ Additional Resources:
 - [endpoints](maintain-endpoints)
 - [tokens](https://claim.kusama.network/)
 - [validator](../../maintain/kusama/maintain-guides-how-to-validate-kusama.md)
-- [nominator](../../maintain/maintain-guides-how-to-nominate-polkadot.md)
+- [nominator](../../learn/learn-nominator.md)
 - [polkadot wiki](https://wiki.polkadot.network/)

docs/general/staking-dashboard.md

@@ -9,7 +9,7 @@ slug: ../staking-dashboard
 
 import RPC from "./../../components/RPC-Connection";
 
-:::info Preliminary Notes
+## Preliminary Notes
 
 The [Polkadot Staking Dashboard](https://staking.polkadot.network/#/overview) supports
 [**proxy accounts**](../learn/learn-proxies.md) and you can import your
@@ -38,7 +38,7 @@ For more information about staking on {{ polkadot: Polkadot :polkadot }}{{ kusam
 visit the [staking page](../learn/learn-staking.md) and the
 [advanced staking page](../learn/learn-staking-advanced.md).
 
-:::
+## Using the Polkadot Staking Dashboard
 
 The [Polkadot Staking Dashboard](https://staking.polkadot.network/#/overview) is a tool only
 dedicated to [staking](../learn/learn-staking.md) on Polkadot,
@@ -67,6 +67,21 @@ The structure of this page follows the sidebar of the staking dashboard. Here yo
 the main features of the dashboard. If you need more information, see the
 [Walkthrough Tutorial](https://youtu.be/hvXLc4H7rA4).
 
+:::info Walk-through Video Tutorials
+
+- [**Nominating**](https://youtu.be/F59N3YKYCRs): Stake your tokens, choose your best validators,
+  and start your staking journey on {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }}.
+- [**Becoming a Pool Member**](https://youtu.be/dDIG7QAApig): Start becoming a part of the Polkadot
+  movement, keep {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} secure by staking
+  minimum 1 DOT and receiving staking rewards.
+- [**Dashboard Walkthrough**](https://youtu.be/hvXLc4H7rA4): Become a Pro using the Staking
+  Dashboard.
+- [**After Staking**](https://youtu.be/58pIe8tt2o4): Nominating on
+  {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} is not a set-and-forget action,
+  learn what you can do with the dashboard after you started staking.
+
+:::
+
 ## Overview
 
 :::info Staking Dashboard Walk-through video tutorial

docs/learn/learn-guides-staking.md

@@ -1,7 +1,7 @@
 ---
 id: learn-guides-staking
 title: Polkadot-JS Guides For Nominators
-sidebar_label: Staking Guides
+sidebar_label: Nominator Guides
 description: Polkadot-JS Guides for Nominators.
 keyword: [nominate, stake, staking, claim, rewards, polkadot-js]
 slug: ../learn-guides-staking
@@ -119,8 +119,7 @@ more details.
 ### Step 3: Stop nominating
 
 At some point, you might decide to stop nominating one or more validators. You can always change who
-you're nominating, but you cannot withdraw your tokens unless you unbond them. Detailed instructions
-are available [here](../maintain/maintain-guides-how-to-nominate-polkadot.md).
+you're nominating, but you cannot withdraw your tokens unless you unbond them.
 
 ## Claiming Rewards with Polkadot-JS
 

docs/learn/learn-guides-transfers.md

@@ -230,8 +230,8 @@ reaped. References may still exist from:
 
 If you have tokens that are bonded, you will need to unbond them before you can reap your account.
 Follow the instructions at
-[Unbonding and Rebonding](../maintain/maintain-guides-how-to-nominate-polkadot.md) to check if you
-have bonded tokens, stop nominating (if necessary) and unbond your tokens.
+[Unbonding and Rebonding](./learn-guides-staking.md#step-1-bond-your-tokens) to check if you have
+bonded tokens, stop nominating (if necessary) and unbond your tokens.
 
 ### Checking for Locks
 

docs/learn/learn-nominator.md

@@ -12,9 +12,11 @@ import RPC from "./../../components/RPC-Connection";
 :::tip New to Staking?
 
 Start your staking journey or explore more information about staking on
-[Polkadot's Home Page](https://polkadot.network/staking/). Discover the new
-[Staking Dashboard](https://staking.polkadot.network/#/overview) that makes staking much easier and
-check this
+[Polkadot's Home Page](https://polkadot.network/staking/). You can learn how staking works by
+reading [this dedicated page](../learn/learn-staking.md).
+
+Discover the new [**Staking Dashboard**](https://staking.polkadot.network/#/overview) that makes
+staking much easier and check this
 [extensive article list](https://support.polkadot.network/support/solutions/articles/65000182104) to
 help you get started.
 {{ polkadot: You can now [stake natively with just 1 DOT and earn staking rewards](https://polkadot.network/blog/nomination-pools-are-live-stake-natively-with-just-1-dot/). :polkadot }}
@@ -47,6 +49,21 @@ The information provided on this page is complementary to that on the
 [**Staking Page**](./learn-staking.md) and [**Advanced Staking Page**](./learn-staking-advanced.md).
 Make sure you read those pages as well before nominating.
 
+## Who are Nominators?
+
+Nominators are one type of participant in the staking subsystem of
+{{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }}. They appoint their stake to the
+validators, the second type of participant. By appointing their stake, they can elect the active set
+of validators and share in the rewards that are paid out.
+
+While the [validators](../maintain/maintain-guides-how-to-validate-polkadot.md) are active
+participants in the network that engage in the block production and finality mechanisms, nominators
+take a slightly more passive role. Being a nominator does not require running a node of your own or
+worrying about online uptime. However, a good nominator performs due diligence on the validators
+that they elect. When looking for validators to nominate, a nominator should pay attention to their
+own reward percentage for nominating a specific validator - as well as the risk that they bear of
+being [slashed](./learn-staking.md#slashing) if the validator gets slashed.
+
 ## Why Nominate?
 
 - You become part of the {{ polkadot: Polkadot :polkadot }}{{ kusama: Kusama :kusama }} movement, a
@@ -79,17 +96,17 @@ you can share the staking rewards they generate.
 
 While your {{ polkadot: DOT :polkadot }}{{ kusama: KSM :kusama }} are staked for nominations, they
 are 'locked' (bonded). You can
-[stop nominating at any time](../maintain/maintain-guides-how-to-nominate-polkadot.md), but remember
-that the action is effective in the next era and does not automatically unbond your funds. Unbonding
-is a separate action, and it takes effect after the unbonding period, which is
+[stop nominating at any time](./learn-guides-staking.md#step-3-stop-nominating), but remember that
+the action is effective in the next era and does not automatically unbond your funds. Unbonding is a
+separate action, and it takes effect after the unbonding period, which is
 {{ polkadot: 28-day long on Polkadot :polkadot }}{{ kusama: 7-day long on Kusama :kusama }}. This is
 calculated by taking the **bonding duration** (in eras), multiplying it by the **length of a single
 era** (in hours), and dividing by the **hours in a day** (24). Example:
 ({{ polkadot: 28 × 24 ÷ 24 = 28 days :polkadot }}{{ kusama: 28 × 6 ÷ 24 = 7 days :kusama }}). A
 staking lock will be visible on the Polkadot-JS UI during the unbonding period, and after it, the
 staking lock can be unlocked, and the bonded funds become free balance you can transfer.
 
-:::info Fast Unstaking feature is live!
+:::info Fast Unstaking
 
 If you accidentally bonded your {{ polkadot: DOT :polkadot }}{{ kusama: KSM :kusama }} or your
 bonded {{ polkadot: DOT :polkadot }}{{ kusama: KSM :kusama }} never backed any active validator, you
@@ -108,7 +125,13 @@ qualify. For more information, visit the
 
 ### Stash & Staking Proxy
 
-The first thing you need to do before becoming a nominator is to make sure you have a
+Nominators are recommended to set up separate stash and staking proxy accounts. Explanation and the
+reasoning for generating distinct accounts for this purpose is elaborated in the
+[keys section](../learn/learn-cryptography.md#keys).
+
+You can generate your stash and staking proxy account via any of the recommended methods, which are
+detailed on the [account generation](../learn/learn-accounts.md#account-generation) page. The first
+thing you need to do before becoming a nominator is to make sure you have a
 [**stash account**](./learn-staking.md/#stash-account-and-staking-proxy) where you can transfer
 funds you want to use for staking. For these accounts, it is recommended to use a "cold wallet"
 solution such as [Ledger](../general/ledger.md) or [Polkadot Vault](../general/polkadot-vault.md).
@@ -130,6 +153,12 @@ one of the following options:
 - to stash: rewards are sent to the stash account as a free balance.
 - to another account: rewards are sent to a user-defined account (not stash).
 
+Starting with runtime version v23 natively included in the client version
+[0.8.23](https://github.com/paritytech/polkadot/releases/tag/v0.8.23), payouts can go to any custom
+address. If you'd like to redirect payments to an account that is neither the staking proxy nor the
+stash account, set one up. Note that setting an exchange address as the recipient of the staking
+rewards is extremely unsafe.
+
 :::info
 
 Being a nominator is made simpler by using the
@@ -293,8 +322,13 @@ corresponding nominators will be slashed.
 
 ## Nominating with the Staking Dashboard
 
-The Staking Dashboard allows to choose pre-selected lists of validators based on user preference, or
-to manually select validators similarly as in the Polkadot-JS UI.
+If you are a beginner, please watch the video below for detailed instructions.
+
+[![Staking Tutorial](https://img.youtube.com/vi/F59N3YKYCRs/0.jpg)](https://www.youtube.com/watch?v=F59N3YKYCRs)
+
+The [Polkadot Staking Dashboard](../general/staking-dashboard.md) allows to choose pre-selected
+lists of validators based on user preference, or to manually select validators similarly as in the
+Polkadot-JS UI.
 
 Pre-selected choices are:
 
@@ -445,7 +479,7 @@ details.
 
 When you go to the [Account actions](https://polkadot.js.org/apps/#/staking/actions) under staking
 page, you should see your bonded accounts and nomination status. If not, you can follow
-[this](../maintain/maintain-guides-how-to-nominate-polkadot.md) guide to configure it first. Your
+[this](./learn-guides-staking.md#nominate-using-polkadot-js) guide to configure it first. Your
 nominations will be effective in the next era; eras are roughly
 {{ polkadot: 24 hours on Polkadot. :polkadot }}{{ kusama: 6 hours on Kusama. :kusama }}
 
@@ -482,7 +516,7 @@ higher, which can be viewed on
 
 ## Guides
 
-- [Be a Nominator (Polkadot)](../maintain/maintain-guides-how-to-nominate-polkadot.md) - Guide on
+- [Be a Nominator (Polkadot)](./learn-guides-staking.md#step-2-nominate-a-validator) - Guide on
   nominating on the Kusama canary network.
-- [Stop Being a Nominator (all networks)](../maintain/maintain-guides-how-to-nominate-polkadot.md) -
-  Guide on stopping nominations and withdrawing tokens.
+- [Stop Being a Nominator (all networks)](./learn-guides-staking#step-3-stop-nominating) - Guide on
+  stopping nominations and withdrawing tokens.

docs/learn/learn-runtime-upgrades.md

@@ -114,7 +114,7 @@ Transactions constructed for runtime `n` will not work for any other runtime `>n
 upgrade occurs before broadcasting a previously constructed transaction, you will need to
 reconstruct it with the appropriate runtime version and corresponding metadata.
 
-### For [Nominators](../maintain/maintain-guides-how-to-nominate-polkadot.md)
+### For [Nominators](./learn-nominator.md)
 
 Runtime upgrades don't require any actions by a nominator, though it is always encouraged to keep
 up-to-date and participate with the latest runtime upgrade motions and releases while keeping an eye

docs/learn/learn-staking.md

@@ -222,9 +222,8 @@ relatively hands-off compared to that of a validator, and even more with
 [nomination pools](./learn-nomination-pools.md). For more information, you can take a look at the
 nominator [guide](learn-nominator.md) to understanding your responsibilities as a nominator.
 
-If you want to become a nominator, see
-[this](../maintain/maintain-guides-how-to-nominate-polkadot.md) guide. If you are a beginner and
-would like to securely stake your tokens using the Polkadot-JS UI, refer to
+If you want to become a nominator, see [this](../learn/learn-nominator.md) guide. If you are a
+beginner and would like to securely stake your tokens using the Polkadot-JS UI, refer to
 [this](https://support.polkadot.network/support/solutions/articles/65000168057-how-do-i-stake-nominate-on-polkadot-)
 support article.
 {{ kusama: The tutorial presented in the support article is demonstrated on Polkadot, but the procedure is the same for Kusama. :kusama }}

docs/maintain/archive/maintain-guides-democracy.md

@@ -201,7 +201,7 @@ Like [vesting](../../learn/learn-DOT.md#lazy-vesting), the tokens that are locke
 unlocked lazily. This means that you, the user, must explicitly call an unlock extrinsic to make
 your funds available again after the lock expires. Unbonding is another term you hear a lot in
 Polkadot, it means withdrawing your DOT that was used in staking. To know more about it, please see
-[here](../maintain-guides-how-to-nominate-polkadot.md).
+[here](../../learn/learn-nominator.md).
 
 You can do this from the "Accounts" page in
 [Polkadot-JS Apps](https://polkadot.js.org/apps/#/accounts), unless you use Ledger (see below).

docs/maintain/maintain-guides-how-to-stop-validating.md

@@ -48,7 +48,8 @@ that **cannot** be removed, and as a result that account cannot be reaped.
 to rebond, purge the session keys, unbond, and wait the unbonding period again before being able to
 transfer your tokens.
 
-See [Unbonding and Rebonding](maintain-guides-how-to-nominate-polkadot.md) for more details.
+See [Unbonding and Rebonding](../learn/learn-guides-staking.md#step-1-bond-your-tokens) for more
+details.
 
 :::
 

docs/maintain/maintain-index.md

@@ -18,8 +18,8 @@ guides to set up a node and run the network.
 
 For more information about being a Kusama maintainer, see the pages below:
 
-- [Nomination Guide](./maintain-guides-how-to-nominate-polkadot.md) - Walkthrough on how to nominate
-  on the Kusama canary network.
+- [Nomination Guide](../learn/learn-nominator.md) - Walkthrough on how to nominate on the Kusama
+  canary network.
 - [Validation Guide (Kusama)](kusama/maintain-guides-how-to-validate-kusama.md) - Walkthrough on how
   to validate on the Kusama canary network.
 

kusama-guide/docusaurus.config.js

@@ -90,6 +90,10 @@ module.exports = {
           {
             to: '/docs/learn-guides-assets-ledger',
             from: ['/docs/kusama-statemine-ledger']
+          },
+          {
+            to: '/docs/learn-nominator',
+            from: ['/docs/maintain-guides-how-to-nominate-polkadot']
           }
         ],
         createRedirects: function (existingPath) {

kusama-guide/sidebars.js

@@ -224,7 +224,7 @@ module.exports = {
               },
               items: [
                 "learn/learn-staking",
-                "maintain/maintain-guides-how-to-nominate-polkadot",
+                "learn/learn-nominator",
                 "learn/learn-nomination-pools",
               ],
             },

polkadot-wiki/docusaurus.config.js

@@ -176,6 +176,10 @@ module.exports = {
           {
             to: '/docs/alpha-program',
             from: ['/docs/builders-program']
+          },
+          {
+            to: '/docs/learn-nominator',
+            from: ['/docs/maintain-guides-how-to-nominate-polkadot']
           }
         ],
         createRedirects: function (existingPath) {

polkadot-wiki/sidebars.js

@@ -745,7 +745,6 @@ module.exports = {
             "maintain/maintain-errors",
           ],
         },
-        "maintain/maintain-guides-how-to-nominate-polkadot",
         {
           type: "category",
           label: "Collator Guides",