From fa50a5cede18393b8b3e8c13b2216d00afacbae9 Mon Sep 17 00:00:00 2001
From: Zanie Blue <contact@zanie.dev>
Date: Wed, 17 Sep 2025 10:12:59 -0500
Subject: [PATCH] Add verbose output to the documentation help section (#15915)

Closes https://github.com/astral-sh/uv/issues/15914
---
 docs/getting-started/help.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/docs/getting-started/help.md b/docs/getting-started/help.md
index b8ab0e96a..0843c2f62 100644
--- a/docs/getting-started/help.md
+++ b/docs/getting-started/help.md
@@ -30,6 +30,23 @@ $ uv help init
 When using the long help menu, uv will attempt to use `less` or `more` to "page" the output so it is
 not all displayed at once. To exit the pager, press `q`.
 
+## Displaying verbose output
+
+The `-v` flag can be used to display verbose output for a command, e.g., for `uv sync`:
+
+```console
+$ uv sync -v
+```
+
+The `-v` flag can be repeated to increase verbosity, e.g.:
+
+```console
+$ uv sync -vv
+```
+
+Often, the verbose output will include additional information about why uv is behaving in a certain
+way.
+
 ## Viewing the version
 
 When seeking help, it's important to determine the version of uv that you're using — sometimes the