diff --git a/apps/build-secrets.mdx b/apps/build-secrets.mdx
index 91b17a8af2..93f549d9dc 100644
--- a/apps/build-secrets.mdx
+++ b/apps/build-secrets.mdx
@@ -1,5 +1,7 @@
 ---
-title: Build Secrets
+title: Docker build secrets on Fly.io
+sidebarTitle: Build secrets
+description: "Use Docker build secrets on Fly.io: mount a secret in your Dockerfile with RUN --mount=type=secret and pass its value with fly deploy --build-secret."
 source_url: https://fly.io/docs/apps/build-secrets/
 ---
 
diff --git a/networking/egress-ips.mdx b/networking/egress-ips.mdx
index 26a394d34e..637f40432f 100644
--- a/networking/egress-ips.mdx
+++ b/networking/egress-ips.mdx
@@ -1,5 +1,6 @@
 ---
-title: Egress IP addresses
+title: "Egress IP addresses: static outbound IPs for Fly Machines"
+sidebarTitle: Egress IP addresses
 description: "Allocate static egress IPs on Fly.io for third-party allowlists, with per-region app-scoped IPv4 and IPv6 pairs, caveats, and migration from machine-scoped IPs."
 source_url: https://fly.io/docs/networking/egress-ips/
 ---
@@ -8,6 +9,8 @@ source_url: https://fly.io/docs/networking/egress-ips/
 
 ## Overview
 
+An egress IP is the source address of outbound connections from your app: the IP that an external API, database or payment provider sees, and the one you add to its allowlist.
+
 - By default, outbound (egress) IPs from Fly Machines are **unstable** and may change.
 - You can allocate **static egress IPs** for an app (both IPv4 and IPv6) via `fly ips allocate-egress`.
 - App-scoped static egress IPs are per-region: you need one for each region where you have machines.