From 7f4644c97d58aba3a24e6885e43fdc46ff1ad26f Mon Sep 17 00:00:00 2001
From: Ryan Duguid <152749594+ryanduguid@users.noreply.github.com>
Date: Thu, 8 Oct 2026 08:36:46 +1100
Subject: [PATCH] Fix source installation instructions and archive link

---
 docs/source/installation.rst | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/docs/source/installation.rst b/docs/source/installation.rst
index 2c9de67..6db4d0a 100644
--- a/docs/source/installation.rst
+++ b/docs/source/installation.rst
@@ -1,17 +1,19 @@
 Installing hpack
 ================
 
-hpack is trivial to install from the Python Package Index. Simply run:
+Install hpack from the Python Package Index with:
 
 .. code-block:: console
 
-    $ pip install hpack
+    $ python -m pip install hpack
 
-Alternatively, feel free to download one of the release tarballs from
-`our GitHub page`_, extract it to your favourite directory, and then run
+Alternatively, download a source archive from `our GitHub page`_, extract it,
+and run the following command from the extracted directory:
 
 .. code-block:: console
 
-    $ python setup.py install
+    $ python -m pip install .
 
 hpack has no external dependencies.
+
+.. _our GitHub page: https://github.com/python-hyper/hpack/tags