diff --git a/gazelle/docs/directives.md b/gazelle/docs/directives.md
index 60f948e4af..5d3ddf7c13 100644
--- a/gazelle/docs/directives.md
+++ b/gazelle/docs/directives.md
@@ -229,9 +229,14 @@ py_libary(
 (directive-python-manifest-file-name)=
 ## `python_manifest_file_name`
 
-:::{error}
-Detailed docs are not yet written.
-:::
+Sets the manifest used to resolve third-party imports in this directory and its
+subdirectories (default: `gazelle_python.yaml`). Paths are relative to the `BUILD`
+file containing the directive. For example, in `a/BUILD.bazel`, select a manifest
+at the repository root with:
+
+```starlark
+# gazelle:python_manifest_file_name ../gazelle_python_a.yaml
+```
 
 
 (directive-python-ignore-files)=