[DOCS] Update the page description for SEO improvement #4 (hashicorp#…

…29166) * Update the page description to improve SEO * Minor updates * Update setup.mdx * Update setup.mdx * Update website/content/docs/secrets/ad/migration-guide.mdx Co-authored-by: Jonathan Frappier <[email protected]> * Update website/content/docs/secrets/ad/index.mdx Co-authored-by: Jonathan Frappier <[email protected]> * Update website/content/docs/secrets/ad/index.mdx Co-authored-by: Jonathan Frappier <[email protected]> --------- Co-authored-by: Jonathan Frappier <[email protected]>
fopina · Dec 12, 2024 · c4be16c · c4be16c
1 parent 11708f1
commit c4be16c
Show file tree

Hide file tree

Showing 11 changed files with 22 additions and 25 deletions.
diff --git a/website/content/docs/secrets/ad/index.mdx b/website/content/docs/secrets/ad/index.mdx
@@ -1,11 +1,11 @@
 ---
 layout: docs
-page_title: Active Directory - Secrets Engines
+page_title: Active Directory secrets engine
 description: >-
-  The Active Directory secrets engine allowing Vault to generate dynamic credentials.
+  Dynamically generate Active Directory (AD) credentials with the Active Directory secrets engine plugin.
 ---
 
-# Active directory secrets engine
+# Active Directory secrets engine
 
 @include 'ad-secrets-deprecation.mdx'
 

diff --git a/website/content/docs/secrets/ad/migration-guide.mdx b/website/content/docs/secrets/ad/migration-guide.mdx
@@ -1,6 +1,6 @@
 ---
 layout: docs
-page_title: Migration Guide - Active Directory - Secrets Engines
+page_title: Migration guide - Active Directory secrets engine
 description: >-
   The guide for migrating from the Active Directory secrets engine to the LDAP secrets engine.
 ---

diff --git a/website/content/docs/secrets/identity/identity-token.mdx b/website/content/docs/secrets/identity/identity-token.mdx
@@ -1,13 +1,12 @@
 ---
 layout: docs
-page_title: Identity Tokens
-description: Details and best practices for identity tokens.
+page_title: Identity tokens
+description: >-
+  Understand the roles and keys associated with identity tokens, and configure per-role templates that allow entity information to be added to the token.
 ---
 
 # Identity tokens
 
-## Introduction
-
 Identity information is used throughout Vault, but it can also be exported for
 use by other applications. An authorized user/application can request a token
 that encapsulates identity information for their associated entity. These

diff --git a/website/content/docs/secrets/identity/index.mdx b/website/content/docs/secrets/identity/index.mdx
@@ -1,14 +1,13 @@
 ---
 layout: docs
-page_title: Identity - Secrets Engines
-description: The Identity secrets engine for Vault manages client identities.
+page_title: Identity secrets engine
+description: >- 
+   Manage Vault client identities with the identity secrets engine. An entity represents a unique client which can have multiple aliases tied back to it.
 ---
 
 # Identity secrets engine
 
-Name: `identity`
-
-The Identity secrets engine is the identity management solution for Vault. It
+The identity secrets engine is the identity management solution for Vault. It
 internally maintains the clients who are recognized by Vault. Each client is
 internally termed as an `Entity`. An entity can have multiple `Aliases`. For
 example, a single user who has accounts in both GitHub and LDAP, can be mapped

diff --git a/website/content/docs/secrets/identity/oidc-provider.mdx b/website/content/docs/secrets/identity/oidc-provider.mdx
@@ -1,6 +1,6 @@
 ---
 layout: docs
-page_title: OIDC Identity Provider
+page_title: OIDC identity provider
 description: >-
   Setup and configuration for Vault as an OpenID Connect (OIDC) identity provider.
 ---

diff --git a/website/content/docs/secrets/key-management/awskms.mdx b/website/content/docs/secrets/key-management/awskms.mdx
@@ -1,7 +1,7 @@
 ---
 layout: docs
-page_title: AWS KMS - Key Management - Secrets Engines
-description: AWS KMS is a supported KMS provider of the Key Management secrets engine.
+page_title: AWS KMS
+description: Manage the lifecycle of keys in AWS KMS with the Key Management secrets engine plugin.
 ---
 
 # AWS KMS

diff --git a/website/content/docs/secrets/key-management/azurekeyvault/index.mdx b/website/content/docs/secrets/key-management/azurekeyvault/index.mdx
@@ -1,7 +1,7 @@
 ---
 layout: docs
-page_title: Azure Key Vault - Key Management - Secrets Engines
-description: Key management secrets engine supports lifecycle management of keys in Azure Key Vault instances.
+page_title: Azure Key Vault
+description: Manage the lifecycle of keys in Azure Key Vault instances with the Key Management secrets engine plugin.
 ---
 
 # Azure Key Vault

diff --git a/website/content/docs/secrets/key-management/azurekeyvault/setup.mdx b/website/content/docs/secrets/key-management/azurekeyvault/setup.mdx
@@ -1,6 +1,6 @@
 ---
 layout: docs
-page_title: Azure Key Vault setup guide
+page_title: Setup guide - Azure Key Vault
 description: Configure the key management secrets engine, and distribute the Vault-managed keys to the target Azure Key Vault instance.
 ---
 

diff --git a/website/content/docs/secrets/key-management/gcpkms/index.mdx b/website/content/docs/secrets/key-management/gcpkms/index.mdx
@@ -1,7 +1,7 @@
 ---
 layout: docs
-page_title: GCP Cloud KMS - Key Management - Secrets Engines
-description: Key management secrets engine supports lifecycle management of keys in GCP Cloud KMS key rings.
+page_title: GCP Cloud KMS
+description: Manage the lifecycle of keys in GCP Cloud KMS key rings with the Key Management secrets engine plugin.
 ---
 
 # GCP Cloud KMS

diff --git a/website/content/docs/secrets/key-management/gcpkms/setup.mdx b/website/content/docs/secrets/key-management/gcpkms/setup.mdx
@@ -1,6 +1,6 @@
 ---
 layout: docs
-page_title: GCP Cloud KMS - Key Management - Secrets Engines
+page_title: Setup guide - GCP Cloud KMS
 description: Configure the key management secrets engine, and distribute the Vault-managed keys to the target GCP Cloud KMS.
 ---
 

diff --git a/website/content/docs/secrets/key-management/index.mdx b/website/content/docs/secrets/key-management/index.mdx
@@ -1,9 +1,8 @@
 ---
 layout: docs
-page_title: Key Management - Secrets Engines
+page_title: Key management secrets engine
 description: >-
-  The key management secrets engine provides a consistent workflow for distribution and lifecycle
-  management of cryptographic keys in various key management service (KMS) providers.
+  Create a consistent workflow for distribution and lifecycle management of cryptographic keys in various key management service (KMS) providers.
 ---
 
 # Key management secrets engine