From 4c779337dfa35affadf0a76a1ed7beb8b415f625 Mon Sep 17 00:00:00 2001
From: Radha <86818441+DrW3RK@users.noreply.github.com>
Date: Thu, 21 Sep 2023 14:57:20 +0100
Subject: [PATCH] Add more context to advanced how-to guides (#5214)

* Add more context to advanced how-to guides

* Update learn-guides-polkadot-opengov.md

* Update learn-guides-polkadot-opengov.md

* Update learn-guides-staking.md

* Update learn-guides-staking-pools.md
---
 docs/learn/learn-guides-identity.md         | 8 ++++++--
 docs/learn/learn-guides-polkadot-opengov.md | 3 +++
 docs/learn/learn-guides-staking-pools.md    | 3 +++
 docs/learn/learn-guides-staking.md          | 3 +++
 4 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/docs/learn/learn-guides-identity.md b/docs/learn/learn-guides-identity.md
index 2cf00986ba61..c98df7016d73 100644
--- a/docs/learn/learn-guides-identity.md
+++ b/docs/learn/learn-guides-identity.md
@@ -2,11 +2,15 @@
 id: learn-guides-identity
 title: Identity How-to Guides
 sidebar_label: Identity
-description: Advanced How-to Guides about Identity.
-keywords: [registrar, identity]
+description: Advanced How-to Guides about Identity - Registrars and Sub-Identity.
+keywords: [registrar, identity, sub-identity]
 slug: ../learn-guides-identity
 ---
 
+This is an advanced guide that is relevant for entities that would like to become registrars or would
+like to set sub-identities to an existing account with an identity. The [learn identity](https://wiki.polkadot.network/docs/learn-identity)
+page provides information on how to set an identity and have it verified.
+
 ## Registrars
 
 ### Becoming a Registrar
diff --git a/docs/learn/learn-guides-polkadot-opengov.md b/docs/learn/learn-guides-polkadot-opengov.md
index 2d6bc6398869..e8d7c372ea60 100644
--- a/docs/learn/learn-guides-polkadot-opengov.md
+++ b/docs/learn/learn-guides-polkadot-opengov.md
@@ -9,6 +9,9 @@ slug: ../learn-guides-polkadot-opengov
 
 import RPC from "./../../components/RPC-Connection";
 
+This page is for advanced users of Polkadot OpenGov. If you would learn about and participate in OpenGov, please navigate
+to the page on [participating in Polkadot Opengov.](https://wiki.polkadot.network/docs/maintain-guides-polkadot-opengov)
+
 ## Cancel or Kill a Referendum
 
 :::info
diff --git a/docs/learn/learn-guides-staking-pools.md b/docs/learn/learn-guides-staking-pools.md
index 9c9cdf599fd2..34e7f5f235bc 100644
--- a/docs/learn/learn-guides-staking-pools.md
+++ b/docs/learn/learn-guides-staking-pools.md
@@ -9,6 +9,9 @@ slug: ../learn-guides-staking-pools
 
 import RPC from "./../../components/RPC-Connection";
 
+This page is for pool creators and maintainers. If you like to participate in staking through nomination pools,
+please navigate to this page on [how to join a nomination pool.](https://support.polkadot.network/support/solutions/articles/65000182376-staking-dashboard-how-to-join-a-nomination-pool)
+
 ## Pool Creation
 
 :::info
diff --git a/docs/learn/learn-guides-staking.md b/docs/learn/learn-guides-staking.md
index f30ceb3ee354..8454644ddad8 100644
--- a/docs/learn/learn-guides-staking.md
+++ b/docs/learn/learn-guides-staking.md
@@ -9,6 +9,9 @@ slug: ../learn-guides-staking
 
 import RPC from "./../../components/RPC-Connection";
 
+This page focuses on the advanced staking features of the network. If you like to learn about staking,
+check this page on the [introduction to staking.](https://wiki.polkadot.network/docs/learn-staking)
+
 ## Claiming Rewards with the Polkadot-JS UI
 
 Anyone can trigger a payout for any validator, as long as they are willing to pay the transaction