diff --git a/doc/stdenv/meta.chapter.md b/doc/stdenv/meta.chapter.md index f6da0bb84be0..b05dcd4c0a99 100644 --- a/doc/stdenv/meta.chapter.md +++ b/doc/stdenv/meta.chapter.md @@ -24,7 +24,8 @@ It is expected that each meta-attribute is one of the following: ### `description` {#var-meta-description} -A short (one-line) description of the package. This is shown by `nix-env -q --description` and also on the Nixpkgs release pages. +A short (one-line) description of the package. +This is displayed on [search.nixos.org](https://search.nixos.org/packages). Don’t include a period at the end. Don’t include newline characters. Capitalise the first character. For brevity, don’t repeat the name of package --- just describe what it does.