diff --git a/doc/stdenv/meta.chapter.md b/doc/stdenv/meta.chapter.md
index 5f3e12ba0041..64924dceb717 100644
--- a/doc/stdenv/meta.chapter.md
+++ b/doc/stdenv/meta.chapter.md
@@ -178,6 +178,7 @@ NixOS tests run in a VM, so they are slower than regular package tests. For more
 Alternatively, you can specify other derivations as tests. You can make use of
 the optional parameter (here: `self`) to inject the correct package without
 relying on non-local definitions, even in the presence of `overrideAttrs`. This
+means `(mypkg.overrideAttrs f).passthru.tests` will be as expected, as long as the
 definition of `tests` does not rely on the original `mypkg` or overrides it in
 all places.