diff --git a/README.md b/README.md
index 8dd6e8011..bf0a56bef 100644
--- a/README.md
+++ b/README.md
@@ -50,7 +50,7 @@ Requires **[uv](https://docs.astral.sh/uv/)** ([install uv](https://github.com/g
 uv tool install specify-cli
 ```
 
-Or install from source using a specific [release](https://github.com/github/spec-kit/releases) tag:
+Or install from source using a specific [release](https://github.com/github/spec-kit/releases) tag (useful if the PyPI version is not yet available for a new release):
 
 ```bash
 uv tool install specify-cli --from git+https://github.com/github/spec-kit.git@vX.Y.Z
diff --git a/docs/installation.md b/docs/installation.md
index 954a4e206..260139f0f 100644
--- a/docs/installation.md
+++ b/docs/installation.md
@@ -11,7 +11,7 @@
 ## Installation
 
 > [!NOTE]
-> The official `specify-cli` package is published to [PyPI](https://pypi.org/project/specify-cli/) by the [github/spec-kit](https://github.com/github/spec-kit) maintainers. Source installs from the GitHub repository are also supported.
+> The official `specify-cli` package is published to [PyPI](https://pypi.org/project/specify-cli/) by the [github/spec-kit](https://github.com/github/spec-kit) maintainers. PyPI publishing follows each GitHub release and may lag briefly. Source installs from the GitHub repository are always available immediately.
 
 ### Persistent Installation (Recommended)