Use uv

Author: charliermarsh

README.md

@@ -120,8 +120,8 @@ Ruff is available as [`ruff`](https://pypi.org/project/ruff/) on PyPI:
 
 ```shell
 # With uv.
-uv add --dev ruff     # to add ruff to your project
-uv tool install ruff  # to install ruff globally
+uv tool install ruff  # Install Ruff globally.
+uv add --dev ruff     # Or add Ruff to your project.
 
 # With pip.
 pip install ruff

docs/faq.md

@@ -220,15 +220,18 @@ Ruff is installable under any Python version from 3.7 onwards.
 
 ## Do I need to install Rust to use Ruff?
 
-Nope! Ruff is available as [`ruff`](https://pypi.org/project/ruff/) on PyPI:
+Nope! Ruff is available as [`ruff`](https://pypi.org/project/ruff/) on PyPI. We recommend installing Ruff with [uv](https://docs.astral.sh/uv/):
 
 ```console
-# With uv.
-$ uv add --dev ruff     # to add ruff to your project
-$ uv tool install ruff  # to install ruff globally
+$ # With uv.
+$ uv tool install ruff  # Install Ruff globally.
+$ uv add --dev ruff     # Or add Ruff to your project.
 
-# With pip
+$ # With pip.
 $ pip install ruff
+
+$ # With pipx.
+$ pipx install ruff
 ```
 
 Ruff ships with wheels for all major platforms, which enables `pip` to install Ruff without relying

docs/installation.md

@@ -1,9 +1,16 @@
 # Installing Ruff
 
-Ruff is available as [`ruff`](https://pypi.org/project/ruff/) on PyPI:
+Ruff is available as [`ruff`](https://pypi.org/project/ruff/) on PyPI. We recommend installing Ruff with [uv](https://docs.astral.sh/uv/):
 
 ```console
+$ # With uv.
+$ uv tool install ruff
+
+$ # With pip.
 $ pip install ruff
+
+$ # With pipx.
+$ pipx install ruff
 ```
 
 Once installed, you can run Ruff from the command line:
@@ -13,7 +20,7 @@ $ ruff check   # Lint all files in the current directory.
 $ ruff format  # Format all files in the current directory.
 ```
 
-Starting with version `0.5.0`, Ruff can be installed with our standalone installers:
+Starting with version `0.5.0`, Ruff can also be installed with our standalone installers:
 
 ```console
 $ # On macOS and Linux.

docs/tutorial.md

@@ -5,10 +5,18 @@ your project. For a more detailed overview, see [_Configuring Ruff_](configurati
 
 ## Getting Started
 
-To start, we'll install Ruff through PyPI (or with your [preferred package manager](installation.md)):
+To start, we'll install Ruff from PyPI. You can install Ruff with [uv](https://docs.astral.sh/uv/), or
+your [preferred package manager](installation.md):
 
 ```console
+$ # With uv.
+$ uv tool install ruff
+
+$ # With pip.
 $ pip install ruff
+
+$ # With pipx.
+$ pipx install ruff
 ```
 
 Let's then assume that our project structure looks like:

python/ruff-ecosystem/README.md

@@ -4,10 +4,10 @@ Compare lint and format results for two different ruff versions (e.g. main and a
 
 ## Installation
 
-From the Ruff project root, install with `pip`:
+From the Ruff project root, install with [uv](https://docs.astral.sh/uv/):
 
 ```shell
-pip install -e ./python/ruff-ecosystem
+uv tool install -e ./python/ruff-ecosystem
 ```
 
 ## Usage