From 62ccbbff4ef3626714d0f522322153c8eece459f Mon Sep 17 00:00:00 2001
From: FishAlchemist <48265002+FishAlchemist@users.noreply.github.com>
Date: Sun, 12 Jan 2025 21:03:30 +0800
Subject: [PATCH 1/3] Add meta titles to documents in guides, excluding
 integration documents.

---
 docs/guides/install-python.md | 7 +++++++
 docs/guides/projects.md       | 7 +++++++
 docs/guides/publish.md        | 5 +++++
 docs/guides/scripts.md        | 7 +++++++
 docs/guides/tools.md          | 5 +++++
 5 files changed, 31 insertions(+)

diff --git a/docs/guides/install-python.md b/docs/guides/install-python.md
index 9cefc830ccb4..92d4b1401924 100644
--- a/docs/guides/install-python.md
+++ b/docs/guides/install-python.md
@@ -1,3 +1,10 @@
+---
+title: Install and Manage Python
+description:
+  Guide to install specific Python versions, manage existing installations, and automate downloads
+  with uv.
+---
+
 # Installing Python
 
 If Python is already installed on your system, uv will
diff --git a/docs/guides/projects.md b/docs/guides/projects.md
index a9d219162b55..2b44a9b57ade 100644
--- a/docs/guides/projects.md
+++ b/docs/guides/projects.md
@@ -1,3 +1,10 @@
+---
+title: Working on projects
+description:
+  Guide to create, manage, and build Python projects with uv, including dependencies and
+  distributions.
+---
+
 # Working on projects
 
 uv supports managing Python projects, which define their dependencies in a `pyproject.toml` file.
diff --git a/docs/guides/publish.md b/docs/guides/publish.md
index d429ea26ba4a..c1314ecc70f5 100644
--- a/docs/guides/publish.md
+++ b/docs/guides/publish.md
@@ -1,3 +1,8 @@
+---
+title: Publishing a package
+description: Guide to build and publish Python packages using uv
+---
+
 # Publishing a package
 
 uv supports building Python packages into source and binary distributions via `uv build` and
diff --git a/docs/guides/scripts.md b/docs/guides/scripts.md
index c6d10af63fde..ace2b943510b 100644
--- a/docs/guides/scripts.md
+++ b/docs/guides/scripts.md
@@ -1,3 +1,10 @@
+---
+title: Run Scripts
+description:
+  Run Python scripts quickly and manage dependencies efficiently using uv. Learn about inline
+  metadata and more.
+---
+
 # Running scripts
 
 A Python script is a file intended for standalone execution, e.g., with `python <script>.py`. Using
diff --git a/docs/guides/tools.md b/docs/guides/tools.md
index 8300d1d5db33..549e9c4a448c 100644
--- a/docs/guides/tools.md
+++ b/docs/guides/tools.md
@@ -1,3 +1,8 @@
+---
+title: Using tools
+description: Guide to run, install, and upgrade Python tools using uv.
+---
+
 # Using tools
 
 Many Python packages provide applications that can be used as tools. uv has specialized support for

From b5a3df2f10b4bb7564691c1e71b00f1ac35cb98e Mon Sep 17 00:00:00 2001
From: FishAlchemist <48265002+FishAlchemist@users.noreply.github.com>
Date: Sun, 12 Jan 2025 23:54:23 +0800
Subject: [PATCH 2/3] To maintain consistency with other parts of the document
 and ensure grammatical accuracy.

Co-authored-by: Charles Tapley Hoyt <cthoyt@gmail.com>
---
 docs/guides/install-python.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/guides/install-python.md b/docs/guides/install-python.md
index 92d4b1401924..ec18013d84bc 100644
--- a/docs/guides/install-python.md
+++ b/docs/guides/install-python.md
@@ -1,5 +1,5 @@
 ---
-title: Install and Manage Python
+title: Installing and Managing Python
 description:
   Guide to install specific Python versions, manage existing installations, and automate downloads
   with uv.

From b1c381e4cb352258e4bb4fc454fc9cb3230fe335 Mon Sep 17 00:00:00 2001
From: Zanie Blue <contact@zanie.dev>
Date: Wed, 15 Jan 2025 14:12:04 -0600
Subject: [PATCH 3/3] Review

---
 docs/guides/install-python.md | 6 +++---
 docs/guides/projects.md       | 4 ++--
 docs/guides/publish.md        | 2 +-
 docs/guides/scripts.md        | 6 +++---
 docs/guides/tools.md          | 4 +++-
 5 files changed, 12 insertions(+), 10 deletions(-)

diff --git a/docs/guides/install-python.md b/docs/guides/install-python.md
index ec18013d84bc..bc3555cdcd2a 100644
--- a/docs/guides/install-python.md
+++ b/docs/guides/install-python.md
@@ -1,8 +1,8 @@
 ---
-title: Installing and Managing Python
+title: Installing and managing Python
 description:
-  Guide to install specific Python versions, manage existing installations, and automate downloads
-  with uv.
+  A guide to using uv to install Python, including requesting specific versions, automatic
+  installation, viewing installed versions, and more.
 ---
 
 # Installing Python
diff --git a/docs/guides/projects.md b/docs/guides/projects.md
index 2b44a9b57ade..aff63e72b5a2 100644
--- a/docs/guides/projects.md
+++ b/docs/guides/projects.md
@@ -1,8 +1,8 @@
 ---
 title: Working on projects
 description:
-  Guide to create, manage, and build Python projects with uv, including dependencies and
-  distributions.
+  A guide to using uv to create and manage Python projects, including adding dependencies, running
+  commands, and building publishable distributions.
 ---
 
 # Working on projects
diff --git a/docs/guides/publish.md b/docs/guides/publish.md
index c1314ecc70f5..9e0fb114d100 100644
--- a/docs/guides/publish.md
+++ b/docs/guides/publish.md
@@ -1,6 +1,6 @@
 ---
 title: Publishing a package
-description: Guide to build and publish Python packages using uv
+description: A guide to using uv to build and publish Python packages to a package index, like PyPI.
 ---
 
 # Publishing a package
diff --git a/docs/guides/scripts.md b/docs/guides/scripts.md
index ace2b943510b..1dbf91b3aa1e 100644
--- a/docs/guides/scripts.md
+++ b/docs/guides/scripts.md
@@ -1,8 +1,8 @@
 ---
-title: Run Scripts
+title: Running scripts
 description:
-  Run Python scripts quickly and manage dependencies efficiently using uv. Learn about inline
-  metadata and more.
+  A guide to using uv to run Python scripts, including support for inline dependency metadata,
+  reproducible scripts, and more.
 ---
 
 # Running scripts
diff --git a/docs/guides/tools.md b/docs/guides/tools.md
index 549e9c4a448c..125a3b83e2af 100644
--- a/docs/guides/tools.md
+++ b/docs/guides/tools.md
@@ -1,6 +1,8 @@
 ---
 title: Using tools
-description: Guide to run, install, and upgrade Python tools using uv.
+description:
+  A guide to using uv to run tools published as Python packages, including one-off invocations with
+  uvx, requesting specific tool versions, installing tools, upgrading tools, and more.
 ---
 
 # Using tools