diff --git a/pkgs/by-name/README.md b/pkgs/by-name/README.md
index aacd1d084af5..61496fcfc48d 100644
--- a/pkgs/by-name/README.md
+++ b/pkgs/by-name/README.md
@@ -18,7 +18,7 @@ pkgs
 
 ```
 
-Where `some-package` is the package name and `so` is the lowercased 2-letter prefix of the package name.
+Where `some-package` is the attribute name corresponding to the package, and `so` is the lowercase 2-letter prefix of the attribute name.
 
 The `package.nix` may look like this: