mirror of
https://github.com/NixOS/nixpkgs.git
synced 2024-11-25 16:33:15 +00:00
b7c525806e
No content was changed, new titles are wrapped with () to signal that they will need to be decided on in a future commit. |
||
---|---|---|
.. | ||
applications | ||
build-support | ||
common-updater | ||
data | ||
desktops | ||
development | ||
games | ||
misc | ||
os-specific | ||
pkgs-lib | ||
servers | ||
shells | ||
stdenv | ||
test | ||
tools | ||
top-level | ||
README.md |
Contributing to Nixpkgs packages
(Conventions)
meta.description
must:- Be short, just one sentence.
- Be capitalized.
- Not start with the package name.
- More generally, it should not refer to the package name.
- Not end with a period (or any punctuation for that matter).
- Aim to inform while avoiding subjective language.
meta.license
must be set and fit the upstream license.- If there is no upstream license,
meta.license
should default tolib.licenses.unfree
. - If in doubt, try to contact the upstream developers for clarification.
- If there is no upstream license,
meta.mainProgram
must be set when appropriate.meta.maintainers
should be set.
See the nixpkgs manual for more details on standard meta-attributes.
Testing changes
To run the main types of tests locally:
- Run package-internal tests with
nix-build --attr pkgs.PACKAGE.passthru.tests
- Run NixOS tests with
nix-build --attr nixosTest.NAME
, whereNAME
is the name of the test listed innixos/tests/all-tests.nix
- Run global package tests with
nix-build --attr tests.PACKAGE
, wherePACKAGE
is the name of the test listed inpkgs/test/default.nix
- See
lib/tests/NAME.nix
for instructions on running specific library tests