diff --git a/apps/build-secrets.mdx b/apps/build-secrets.mdx
index 91b17a8af2..ec0c2b5144 100644
--- a/apps/build-secrets.mdx
+++ b/apps/build-secrets.mdx
@@ -1,5 +1,6 @@
 ---
 title: Build Secrets
+description: "Use secrets in a Docker build on Fly.io: mount them in a RUN step with --mount=type=secret, pass values with fly deploy --build-secret, and test locally."
 source_url: https://fly.io/docs/apps/build-secrets/
 ---
 
diff --git a/index.mdx b/index.mdx
index f8f62a0222..50ec45ea63 100644
--- a/index.mdx
+++ b/index.mdx
@@ -1,5 +1,6 @@
 ---
 title: Fly.io developer documentation
+description: "Learn to build, deploy, and run apps and AI agents on Fly.io. Find guides and reference docs for Fly Machines, Sprites, Managed Postgres, networking, and flyctl."
 source_url: https://fly.io/docs/
 ---
 
@@ -21,7 +22,7 @@ brew install flyctl
 **Step 2:** Run `fly launch`
   </div>
 
-  <img src="/images/doc-main.png" alt="Illustration by Annie Ruygt of Frankie the hot air balloon waving to a bird sitting on a hour roof" />
+  <img src="/images/doc-main.png" alt="Illustration by Annie Ruygt of Frankie the hot air balloon waving to a bird sitting on a house roof" />
 </div>
 
 ## Explore Fly.io by features
@@ -107,7 +108,7 @@ Or framework. You know what we mean. Check out the docs specific to your tech so
   <img src="/images/fly-map.png" alt="" />
 
 <div className="grid grid-cols-2 items-center">
-  <img src="/images/help.png" alt="Illustration by Annie Ruygt of Frankie the hot air balloon waving to a bird sitting on a hour roof" />
+  <img src="/images/help.png" alt="Illustration by Annie Ruygt of Frankie the hot air balloon in a fire helmet, holding a ladder up to a cat in a tree while two birds watch" />
   <div className="space-y-2">
     <h2>Could you use more help?</h2>
     <p>Our Community forum and Support team have the answers.</p>