diff --git a/lib/meta.nix b/lib/meta.nix
index c8e67cbc70e2..675e1912d4be 100644
--- a/lib/meta.nix
+++ b/lib/meta.nix
@@ -116,6 +116,10 @@ rec {
           platform, or `meta.platforms` is not present.
 
        2. None of `meta.badPlatforms` pattern matches the given platform.
+
+     Example:
+       lib.meta.availableOn { system = "aarch64-darwin"; } pkg.zsh
+       => true
   */
   availableOn = platform: pkg:
     ((!pkg?meta.platforms) || any (platformMatch platform) pkg.meta.platforms) &&