nixpkgs/doc
Adam Joseph 81bc106e08 meta.sourceProvenance documentation: clarify it is unaffected by changes to meta.license
This commit clarifies that the meaning of the `meta.sourceProvenance`
field is independent of and unaffected by the value of the
`meta.license` field.  This is based on the intent of the RFC author
as expressed here:

  https://github.com/NixOS/nixpkgs/pull/161098#issuecomment-1081270201

This clarification is added for two reasons:

1. If in the future there should be some disagreement about what
   `sourceProvenance` to assign to a package, this may help resolve
   the disagreement.  Any interpretation of `sourceProvenance` which
   is influenced by the `meta.license` is clearly an incorrect
   interpretation.

2. If it should turn out that it is impossible to disentangle
   `sourceProvenance` from `meta.license`, this would indicate the
   need for changes to the `sourceProvenance` scheme.  That change
   might be as simple as replacing the sentence added by this commit
   with some other sentence explaining how the two fields influence
   each other.

This commit implements the recommendation made in the paragraph of
this comments which begins with "Please say this explicitly...":

  https://github.com/NixOS/nixpkgs/pull/161098#issuecomment-1081309089
2022-05-30 16:27:34 +08:00
..
build-aux/pandoc-filters doc: remove reference to unix-man-urls.lua 2021-12-28 13:26:35 +01:00
builders doc/testers: Mention nixosTests in nixosTest doc 2022-05-05 13:08:05 +02:00
contributing doc: clarify what a 'mass rebuild' is 2022-05-09 12:31:21 +02:00
doc-support doc: Add Nixpkgs config options reference 2022-05-02 10:21:05 +02:00
functions nixos/nixpkgs/doc: fix typo in the signature of attrsets.zipAttrs 2022-03-13 13:59:51 +01:00
hooks doc/hooks/index.xml: Fix typo and terminology 2022-04-18 11:57:35 +02:00
languages-frameworks coqPackages: etc 2022-05-25 20:00:25 +02:00
old doc/*: editorconfig fixes 2020-07-31 15:06:53 +10:00
stdenv meta.sourceProvenance documentation: clarify it is unaffected by changes to meta.license 2022-05-30 16:27:34 +08:00
using Merge pull request #171163 from hercules-ci/nixpkgs-config-doc 2022-05-19 20:51:38 +02:00
.gitignore doc: format the documentation (#57102) 2019-03-08 21:07:11 -08:00
default.nix doc: Fix make in nix-shell 2021-06-05 13:25:48 +02:00
functions.xml doc/functions/generators: convert to CommonMark 2021-06-11 06:06:42 -07:00
Makefile doc: Add helper for converting DocBook files to Markdown 2021-07-13 02:21:22 +02:00
manual.xml doc: move testers to their own chapter 2022-04-22 16:24:29 +03:00
overrides.css doc: Make callout marks in code unselectable 2020-01-14 15:24:57 +01:00
preface.chapter.md doc: prepare for commonmark 2021-06-07 06:34:59 +02:00
README.md doc/README.md: Add more links 2021-03-06 12:35:33 +01:00
release-notes.xml treewide: use https for nixos.org and hydra.nixos.org 2020-05-03 22:14:21 -07:00
shell.nix doc: fix shell.nix (#109816) 2021-01-19 12:46:51 -05:00
style.css manual: limit text width 2019-01-08 15:08:42 +00:00

Nixpkgs/doc

This directory houses the sources files for the Nixpkgs manual.

You can find the rendered documentation for Nixpkgs unstable on nixos.org.

Docs for Nixpkgs stable are also available.

If you want to contribute to the documentation, here's how to do it.

If you're only getting started with Nix, go to nixos.org/learn.