From 4008845f7c7c4bd553d8ed58eea9a47f6221bf26 Mon Sep 17 00:00:00 2001
From: Dan Heath <76443935+Dan-Heath@users.noreply.github.com>
Date: Mon, 25 Nov 2024 16:39:40 +0000
Subject: [PATCH] backport of commit 36e93c39538022f652787df2648ec17500f4765a

---
 website/content/docs/developing/building.mdx      | 3 ++-
 website/content/docs/developing/index.mdx         | 3 ++-
 website/content/docs/developing/ui.mdx            | 3 ++-
 website/content/docs/integrations/index.mdx       | 4 ++--
 website/content/docs/integrations/vault/index.mdx | 4 ++--
 5 files changed, 10 insertions(+), 7 deletions(-)

diff --git a/website/content/docs/developing/building.mdx b/website/content/docs/developing/building.mdx
index 9c323fce8f..5b81627f51 100644
--- a/website/content/docs/developing/building.mdx
+++ b/website/content/docs/developing/building.mdx
@@ -1,7 +1,8 @@
 ---
 layout: docs
 page_title: Build Boundary
-description: Build Boundary from source
+description: >-
+  Learn how to build Boundary from the source. Discover resources to compile a cross-platform build and troubleshoot UI assets.
 ---
 
 # Build Boundary
diff --git a/website/content/docs/developing/index.mdx b/website/content/docs/developing/index.mdx
index e9c285505e..b0d15a7927 100644
--- a/website/content/docs/developing/index.mdx
+++ b/website/content/docs/developing/index.mdx
@@ -1,7 +1,8 @@
 ---
 layout: docs
 page_title: Develop Boundary
-description: Develop Boundary
+description: >-
+    Discover resources to help you develop Boundary.
 ---
 
 # Develop Boundary
diff --git a/website/content/docs/developing/ui.mdx b/website/content/docs/developing/ui.mdx
index 2a92cbeabc..55de5173d7 100644
--- a/website/content/docs/developing/ui.mdx
+++ b/website/content/docs/developing/ui.mdx
@@ -1,7 +1,8 @@
 ---
 layout: docs
 page_title: Develop the UI
-description: Develop the Boundary user interface
+description: >-
+    Learn how to develop the Boundary user interface locally for testing. Use dev mode to run a local fork of the UI without building it into the binary.
 ---
 
 # Develop the Boundary user interface
diff --git a/website/content/docs/integrations/index.mdx b/website/content/docs/integrations/index.mdx
index efb5d34a5c..55a23b5213 100644
--- a/website/content/docs/integrations/index.mdx
+++ b/website/content/docs/integrations/index.mdx
@@ -1,8 +1,8 @@
 ---
 layout: docs
 page_title: Integrations
-description: |-
- Integrations that extend Boundary
+description: >-
+    Discover integrations that extend Boundary's features and capabilities.
 ---
 
 # Overview
diff --git a/website/content/docs/integrations/vault/index.mdx b/website/content/docs/integrations/vault/index.mdx
index 7b4c0fd289..4a296e0004 100644
--- a/website/content/docs/integrations/vault/index.mdx
+++ b/website/content/docs/integrations/vault/index.mdx
@@ -1,8 +1,8 @@
 ---
 layout: docs
 page_title: Vault integration
-description: |-
- Describes the benefits of integrating HashiCorp Boundary and Vault.
+description: >-
+  Understand the security benefits of integrating Boundary and Vault to manage secrets and broker or inject credentials. Set up Vault as an OIDC bridge provider.
 ---
 
 # Vault integration