doc: system.environmentPackages -> environment.systemPackages
This commit is contained in:
Yegor Timoshenko
Orivej Desh
parent
ca88a5ff9c
commit
a0aeb2381e
|
|
@ -7,123 +7,123 @@
|
||||||
<title>Reviewing contributions</title>
|
<title>Reviewing contributions</title>
|
||||||
|
|
||||||
<warning>
|
<warning>
|
||||||
<para>The following section is a draft and reviewing policy is still being
|
<para>The following section is a draft and reviewing policy is still being
|
||||||
discussed.</para>
|
discussed.</para>
|
||||||
</warning>
|
</warning>
|
||||||
|
|
||||||
<para>The nixpkgs projects receives a fairly high number of contributions via
|
<para>The nixpkgs projects receives a fairly high number of contributions via
|
||||||
GitHub pull-requests. Reviewing and approving these is an important task and a
|
GitHub pull-requests. Reviewing and approving these is an important task and a
|
||||||
way to contribute to the project.</para>
|
way to contribute to the project.</para>
|
||||||
|
|
||||||
<para>The high change rate of nixpkgs make any pull request that is open for
|
<para>The high change rate of nixpkgs make any pull request that is open for
|
||||||
long enough subject to conflicts that will require extra work from the
|
long enough subject to conflicts that will require extra work from the
|
||||||
submitter or the merger. Reviewing pull requests in a timely manner and being
|
submitter or the merger. Reviewing pull requests in a timely manner and being
|
||||||
responsive to the comments is the key to avoid these. GitHub provides sort
|
responsive to the comments is the key to avoid these. GitHub provides sort
|
||||||
filters that can be used to see the <link
|
filters that can be used to see the <link
|
||||||
xlink:href="https://github.com/NixOS/nixpkgs/pulls?q=is%3Apr+is%3Aopen+sort%3Aupdated-desc">most
|
xlink:href="https://github.com/NixOS/nixpkgs/pulls?q=is%3Apr+is%3Aopen+sort%3Aupdated-desc">most
|
||||||
recently</link> and the <link
|
recently</link> and the <link
|
||||||
xlink:href="https://github.com/NixOS/nixpkgs/pulls?q=is%3Apr+is%3Aopen+sort%3Aupdated-asc">least
|
xlink:href="https://github.com/NixOS/nixpkgs/pulls?q=is%3Apr+is%3Aopen+sort%3Aupdated-asc">least
|
||||||
recently</link> updated pull-requests.</para>
|
recently</link> updated pull-requests.</para>
|
||||||
|
|
||||||
<para>When reviewing a pull request, please always be nice and polite.
|
<para>When reviewing a pull request, please always be nice and polite.
|
||||||
Controversial changes can lead to controversial opinions, but it is important
|
Controversial changes can lead to controversial opinions, but it is important
|
||||||
to respect every community members and their work.</para>
|
to respect every community members and their work.</para>
|
||||||
|
|
||||||
<para>GitHub provides reactions, they are a simple and quick way to provide
|
<para>GitHub provides reactions, they are a simple and quick way to provide
|
||||||
feedback to pull-requests or any comments. The thumb-down reaction should be
|
feedback to pull-requests or any comments. The thumb-down reaction should be
|
||||||
used with care and if possible accompanied with some explanations so the
|
used with care and if possible accompanied with some explanations so the
|
||||||
submitter has directions to improve his contribution.</para>
|
submitter has directions to improve his contribution.</para>
|
||||||
|
|
||||||
<para>Pull-requests reviews should include a list of what has been reviewed in a
|
<para>Pull-requests reviews should include a list of what has been reviewed in a
|
||||||
comment, so other reviewers and mergers can know the state of the
|
comment, so other reviewers and mergers can know the state of the
|
||||||
review.</para>
|
review.</para>
|
||||||
|
|
||||||
<para>All the review template samples provided in this section are generic and
|
<para>All the review template samples provided in this section are generic and
|
||||||
meant as examples. Their usage is optional and the reviewer is free to adapt
|
meant as examples. Their usage is optional and the reviewer is free to adapt
|
||||||
them to his liking.</para>
|
them to his liking.</para>
|
||||||
|
|
||||||
<section><title>Package updates</title>
|
<section><title>Package updates</title>
|
||||||
|
|
||||||
<para>A package update is the most trivial and common type of pull-request.
|
<para>A package update is the most trivial and common type of pull-request.
|
||||||
These pull-requests mainly consist in updating the version part of the package
|
These pull-requests mainly consist in updating the version part of the package
|
||||||
name and the source hash.</para>
|
name and the source hash.</para>
|
||||||
<para>It can happen that non trivial updates include patches or more complex
|
<para>It can happen that non trivial updates include patches or more complex
|
||||||
changes.</para>
|
changes.</para>
|
||||||
|
|
||||||
<para>Reviewing process:</para>
|
<para>Reviewing process:</para>
|
||||||
|
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem><para>Add labels to the pull-request. (Requires commit
|
<listitem><para>Add labels to the pull-request. (Requires commit
|
||||||
rights)</para>
|
rights)</para>
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem><para><literal>8.has: package (update)</literal> and any topic
|
<listitem><para><literal>8.has: package (update)</literal> and any topic
|
||||||
label that fit the updated package.</para></listitem>
|
label that fit the updated package.</para></listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem><para>Ensure that the package versioning is fitting the
|
<listitem><para>Ensure that the package versioning is fitting the
|
||||||
guidelines.</para></listitem>
|
guidelines.</para></listitem>
|
||||||
<listitem><para>Ensure that the commit text is fitting the
|
<listitem><para>Ensure that the commit text is fitting the
|
||||||
guidelines.</para></listitem>
|
guidelines.</para></listitem>
|
||||||
<listitem><para>Ensure that the package maintainers are notified.</para>
|
<listitem><para>Ensure that the package maintainers are notified.</para>
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem><para>mention-bot usually notify GitHub users based on the
|
<listitem><para>mention-bot usually notify GitHub users based on the
|
||||||
submitted changes, but it can happen that it misses some of the
|
submitted changes, but it can happen that it misses some of the
|
||||||
package maintainers.</para></listitem>
|
package maintainers.</para></listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem><para>Ensure that the meta field contains correct
|
<listitem><para>Ensure that the meta field contains correct
|
||||||
information.</para>
|
information.</para>
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem><para>License can change with version updates, so it should be
|
<listitem><para>License can change with version updates, so it should be
|
||||||
checked to be fitting upstream license.</para></listitem>
|
checked to be fitting upstream license.</para></listitem>
|
||||||
<listitem><para>If the package has no maintainer, a maintainer must be
|
<listitem><para>If the package has no maintainer, a maintainer must be
|
||||||
set. This can be the update submitter or a community member that
|
set. This can be the update submitter or a community member that
|
||||||
accepts to take maintainership of the package.</para></listitem>
|
accepts to take maintainership of the package.</para></listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem><para>Ensure that the code contains no typos.</para></listitem>
|
<listitem><para>Ensure that the code contains no typos.</para></listitem>
|
||||||
<listitem><para>Building the package locally.</para>
|
<listitem><para>Building the package locally.</para>
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem><para>Pull-requests are often targeted to the master or staging
|
<listitem><para>Pull-requests are often targeted to the master or staging
|
||||||
branch so building the pull-request locally as it is submitted can
|
branch so building the pull-request locally as it is submitted can
|
||||||
trigger a large amount of source builds.</para>
|
trigger a large amount of source builds.</para>
|
||||||
<para>It is possible to rebase the changes on nixos-unstable or
|
<para>It is possible to rebase the changes on nixos-unstable or
|
||||||
nixpkgs-unstable for easier review by running the following commands
|
nixpkgs-unstable for easier review by running the following commands
|
||||||
from a nixpkgs clone.
|
from a nixpkgs clone.
|
||||||
<screen>
|
<screen>
|
||||||
$ git remote add channels https://github.com/NixOS/nixpkgs-channels.git <co
|
$ git remote add channels https://github.com/NixOS/nixpkgs-channels.git <co
|
||||||
xml:id='reviewing-rebase-1' />
|
xml:id='reviewing-rebase-1' />
|
||||||
$ git fetch channels nixos-unstable <co xml:id='reviewing-rebase-2' />
|
$ git fetch channels nixos-unstable <co xml:id='reviewing-rebase-2' />
|
||||||
$ git fetch origin pull/PRNUMBER/head <co xml:id='reviewing-rebase-3' />
|
$ git fetch origin pull/PRNUMBER/head <co xml:id='reviewing-rebase-3' />
|
||||||
$ git rebase --onto nixos-unstable BASEBRANCH FETCH_HEAD <co
|
$ git rebase --onto nixos-unstable BASEBRANCH FETCH_HEAD <co
|
||||||
xml:id='reviewing-rebase-4' />
|
xml:id='reviewing-rebase-4' />
|
||||||
</screen>
|
</screen>
|
||||||
<calloutlist>
|
<calloutlist>
|
||||||
<callout arearefs='reviewing-rebase-1'>
|
<callout arearefs='reviewing-rebase-1'>
|
||||||
<para>This should be done only once to be able to fetch channel
|
<para>This should be done only once to be able to fetch channel
|
||||||
branches from the nixpkgs-channels repository.</para>
|
branches from the nixpkgs-channels repository.</para>
|
||||||
</callout>
|
</callout>
|
||||||
<callout arearefs='reviewing-rebase-2'>
|
<callout arearefs='reviewing-rebase-2'>
|
||||||
<para>Fetching the nixos-unstable branch.</para>
|
<para>Fetching the nixos-unstable branch.</para>
|
||||||
</callout>
|
</callout>
|
||||||
<callout arearefs='reviewing-rebase-3'>
|
<callout arearefs='reviewing-rebase-3'>
|
||||||
<para>Fetching the pull-request changes, <varname>PRNUMBER</varname>
|
<para>Fetching the pull-request changes, <varname>PRNUMBER</varname>
|
||||||
is the number at the end of the pull-request title and
|
is the number at the end of the pull-request title and
|
||||||
<varname>BASEBRANCH</varname> the base branch of the
|
<varname>BASEBRANCH</varname> the base branch of the
|
||||||
pull-request.</para>
|
pull-request.</para>
|
||||||
</callout>
|
</callout>
|
||||||
<callout arearefs='reviewing-rebase-3'>
|
<callout arearefs='reviewing-rebase-3'>
|
||||||
<para>Rebasing the pull-request changes to the nixos-unstable
|
<para>Rebasing the pull-request changes to the nixos-unstable
|
||||||
branch.</para>
|
branch.</para>
|
||||||
</callout>
|
</callout>
|
||||||
</calloutlist>
|
</calloutlist>
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>The <link xlink:href="https://github.com/madjar/nox">nox</link>
|
<para>The <link xlink:href="https://github.com/madjar/nox">nox</link>
|
||||||
tool can be used to review a pull-request content in a single command.
|
tool can be used to review a pull-request content in a single command.
|
||||||
It doesn't rebase on a channel branch so it might trigger multiple
|
It doesn't rebase on a channel branch so it might trigger multiple
|
||||||
source builds. <varname>PRNUMBER</varname> should be replaced by the
|
source builds. <varname>PRNUMBER</varname> should be replaced by the
|
||||||
number at the end of the pull-request title.</para>
|
number at the end of the pull-request title.</para>
|
||||||
<screen>
|
<screen>
|
||||||
$ nix-shell -p nox --run "nox-review -k pr PRNUMBER"
|
$ nix-shell -p nox --run "nox-review -k pr PRNUMBER"
|
||||||
|
|
@ -153,42 +153,42 @@ $ nix-shell -p nox --run "nox-review -k pr PRNUMBER"
|
||||||
|
|
||||||
<section><title>New packages</title>
|
<section><title>New packages</title>
|
||||||
|
|
||||||
<para>New packages are a common type of pull-requests. These pull requests
|
<para>New packages are a common type of pull-requests. These pull requests
|
||||||
consists in adding a new nix-expression for a package.</para>
|
consists in adding a new nix-expression for a package.</para>
|
||||||
|
|
||||||
<para>Reviewing process:</para>
|
<para>Reviewing process:</para>
|
||||||
|
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem><para>Add labels to the pull-request. (Requires commit
|
<listitem><para>Add labels to the pull-request. (Requires commit
|
||||||
rights)</para>
|
rights)</para>
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem><para><literal>8.has: package (new)</literal> and any topic
|
<listitem><para><literal>8.has: package (new)</literal> and any topic
|
||||||
label that fit the new package.</para></listitem>
|
label that fit the new package.</para></listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem><para>Ensure that the package versioning is fitting the
|
<listitem><para>Ensure that the package versioning is fitting the
|
||||||
guidelines.</para></listitem>
|
guidelines.</para></listitem>
|
||||||
<listitem><para>Ensure that the commit name is fitting the
|
<listitem><para>Ensure that the commit name is fitting the
|
||||||
guidelines.</para></listitem>
|
guidelines.</para></listitem>
|
||||||
<listitem><para>Ensure that the meta field contains correct
|
<listitem><para>Ensure that the meta field contains correct
|
||||||
information.</para>
|
information.</para>
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem><para>License must be checked to be fitting upstream
|
<listitem><para>License must be checked to be fitting upstream
|
||||||
license.</para></listitem>
|
license.</para></listitem>
|
||||||
<listitem><para>Platforms should be set or the package will not get binary
|
<listitem><para>Platforms should be set or the package will not get binary
|
||||||
substitutes.</para></listitem>
|
substitutes.</para></listitem>
|
||||||
<listitem><para>A maintainer must be set, this can be the package
|
<listitem><para>A maintainer must be set, this can be the package
|
||||||
submitter or a community member that accepts to take maintainership of
|
submitter or a community member that accepts to take maintainership of
|
||||||
the package.</para></listitem>
|
the package.</para></listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem><para>Ensure that the code contains no typos.</para></listitem>
|
<listitem><para>Ensure that the code contains no typos.</para></listitem>
|
||||||
<listitem><para>Ensure the package source.</para>
|
<listitem><para>Ensure the package source.</para>
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem><para>Mirrors urls should be used when
|
<listitem><para>Mirrors urls should be used when
|
||||||
available.</para></listitem>
|
available.</para></listitem>
|
||||||
<listitem><para>The most appropriate function should be used (e.g.
|
<listitem><para>The most appropriate function should be used (e.g.
|
||||||
packages from GitHub should use
|
packages from GitHub should use
|
||||||
<literal>fetchFromGitHub</literal>).</para></listitem>
|
<literal>fetchFromGitHub</literal>).</para></listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
</listitem>
|
</listitem>
|
||||||
|
|
@ -223,49 +223,49 @@ $ nix-shell -p nox --run "nox-review -k pr PRNUMBER"
|
||||||
|
|
||||||
<section><title>Module updates</title>
|
<section><title>Module updates</title>
|
||||||
|
|
||||||
<para>Module updates are submissions changing modules in some ways. These often
|
<para>Module updates are submissions changing modules in some ways. These often
|
||||||
contains changes to the options or introduce new options.</para>
|
contains changes to the options or introduce new options.</para>
|
||||||
|
|
||||||
<para>Reviewing process</para>
|
<para>Reviewing process</para>
|
||||||
|
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem><para>Add labels to the pull-request. (Requires commit
|
<listitem><para>Add labels to the pull-request. (Requires commit
|
||||||
rights)</para>
|
rights)</para>
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem><para><literal>8.has: module (update)</literal> and any topic
|
<listitem><para><literal>8.has: module (update)</literal> and any topic
|
||||||
label that fit the module.</para></listitem>
|
label that fit the module.</para></listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem><para>Ensure that the module maintainers are notified.</para>
|
<listitem><para>Ensure that the module maintainers are notified.</para>
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem><para>Mention-bot notify GitHub users based on the submitted
|
<listitem><para>Mention-bot notify GitHub users based on the submitted
|
||||||
changes, but it can happen that it miss some of the package
|
changes, but it can happen that it miss some of the package
|
||||||
maintainers.</para></listitem>
|
maintainers.</para></listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem><para>Ensure that the module tests, if any, are
|
<listitem><para>Ensure that the module tests, if any, are
|
||||||
succeeding.</para></listitem>
|
succeeding.</para></listitem>
|
||||||
<listitem><para>Ensure that the introduced options are correct.</para>
|
<listitem><para>Ensure that the introduced options are correct.</para>
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem><para>Type should be appropriate (string related types differs
|
<listitem><para>Type should be appropriate (string related types differs
|
||||||
in their merging capabilities, <literal>optionSet</literal> and
|
in their merging capabilities, <literal>optionSet</literal> and
|
||||||
<literal>string</literal> types are deprecated).</para></listitem>
|
<literal>string</literal> types are deprecated).</para></listitem>
|
||||||
<listitem><para>Description, default and example should be
|
<listitem><para>Description, default and example should be
|
||||||
provided.</para></listitem>
|
provided.</para></listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem><para>Ensure that option changes are backward compatible.</para>
|
<listitem><para>Ensure that option changes are backward compatible.</para>
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem><para><literal>mkRenamedOptionModule</literal> and
|
<listitem><para><literal>mkRenamedOptionModule</literal> and
|
||||||
<literal>mkAliasOptionModule</literal> functions provide way to make
|
<literal>mkAliasOptionModule</literal> functions provide way to make
|
||||||
option changes backward compatible.</para></listitem>
|
option changes backward compatible.</para></listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem><para>Ensure that removed options are declared with
|
<listitem><para>Ensure that removed options are declared with
|
||||||
<literal>mkRemovedOptionModule</literal></para></listitem>
|
<literal>mkRemovedOptionModule</literal></para></listitem>
|
||||||
<listitem><para>Ensure that changes that are not backward compatible are
|
<listitem><para>Ensure that changes that are not backward compatible are
|
||||||
mentioned in release notes.</para></listitem>
|
mentioned in release notes.</para></listitem>
|
||||||
<listitem><para>Ensure that documentations affected by the change is
|
<listitem><para>Ensure that documentations affected by the change is
|
||||||
updated.</para></listitem>
|
updated.</para></listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
|
|
||||||
|
|
@ -294,37 +294,37 @@ $ nix-shell -p nox --run "nox-review -k pr PRNUMBER"
|
||||||
<para>New modules submissions introduce a new module to NixOS.</para>
|
<para>New modules submissions introduce a new module to NixOS.</para>
|
||||||
|
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem><para>Add labels to the pull-request. (Requires commit
|
<listitem><para>Add labels to the pull-request. (Requires commit
|
||||||
rights)</para>
|
rights)</para>
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem><para><literal>8.has: module (new)</literal> and any topic label
|
<listitem><para><literal>8.has: module (new)</literal> and any topic label
|
||||||
that fit the module.</para></listitem>
|
that fit the module.</para></listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem><para>Ensure that the module tests, if any, are
|
<listitem><para>Ensure that the module tests, if any, are
|
||||||
succeeding.</para></listitem>
|
succeeding.</para></listitem>
|
||||||
<listitem><para>Ensure that the introduced options are correct.</para>
|
<listitem><para>Ensure that the introduced options are correct.</para>
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem><para>Type should be appropriate (string related types differs
|
<listitem><para>Type should be appropriate (string related types differs
|
||||||
in their merging capabilities, <literal>optionSet</literal> and
|
in their merging capabilities, <literal>optionSet</literal> and
|
||||||
<literal>string</literal> types are deprecated).</para></listitem>
|
<literal>string</literal> types are deprecated).</para></listitem>
|
||||||
<listitem><para>Description, default and example should be
|
<listitem><para>Description, default and example should be
|
||||||
provided.</para></listitem>
|
provided.</para></listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem><para>Ensure that module <literal>meta</literal> field is
|
<listitem><para>Ensure that module <literal>meta</literal> field is
|
||||||
present</para>
|
present</para>
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem><para>Maintainers should be declared in
|
<listitem><para>Maintainers should be declared in
|
||||||
<literal>meta.maintainers</literal>.</para></listitem>
|
<literal>meta.maintainers</literal>.</para></listitem>
|
||||||
<listitem><para>Module documentation should be declared with
|
<listitem><para>Module documentation should be declared with
|
||||||
<literal>meta.doc</literal>.</para></listitem>
|
<literal>meta.doc</literal>.</para></listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
</listitem>
|
</listitem>
|
||||||
<listitem><para>Ensure that the module respect other modules
|
<listitem><para>Ensure that the module respect other modules
|
||||||
functionality.</para>
|
functionality.</para>
|
||||||
<itemizedlist>
|
<itemizedlist>
|
||||||
<listitem><para>For example, enabling a module should not open firewall
|
<listitem><para>For example, enabling a module should not open firewall
|
||||||
ports by default.</para></listitem>
|
ports by default.</para></listitem>
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
</listitem>
|
</listitem>
|
||||||
|
|
@ -340,7 +340,7 @@ $ nix-shell -p nox --run "nox-review -k pr PRNUMBER"
|
||||||
- [ ] options have default
|
- [ ] options have default
|
||||||
- [ ] options have example
|
- [ ] options have example
|
||||||
- [ ] options have descriptions
|
- [ ] options have descriptions
|
||||||
- [ ] No unneeded package is added to system.environmentPackages
|
- [ ] No unneeded package is added to environment.systemPackages
|
||||||
- [ ] meta.maintainers is set
|
- [ ] meta.maintainers is set
|
||||||
- [ ] module documentation is declared in meta.doc
|
- [ ] module documentation is declared in meta.doc
|
||||||
|
|
||||||
|
|
@ -355,22 +355,22 @@ $ nix-shell -p nox --run "nox-review -k pr PRNUMBER"
|
||||||
|
|
||||||
<para>Other type of submissions requires different reviewing steps.</para>
|
<para>Other type of submissions requires different reviewing steps.</para>
|
||||||
|
|
||||||
<para>If you consider having enough knowledge and experience in a topic and
|
<para>If you consider having enough knowledge and experience in a topic and
|
||||||
would like to be a long-term reviewer for related submissions, please contact
|
would like to be a long-term reviewer for related submissions, please contact
|
||||||
the current reviewers for that topic. They will give you information about the
|
the current reviewers for that topic. They will give you information about the
|
||||||
reviewing process.
|
reviewing process.
|
||||||
The main reviewers for a topic can be hard to find as there is no list, but
|
The main reviewers for a topic can be hard to find as there is no list, but
|
||||||
checking past pull-requests to see who reviewed or git-blaming the code to see
|
checking past pull-requests to see who reviewed or git-blaming the code to see
|
||||||
who committed to that topic can give some hints.</para>
|
who committed to that topic can give some hints.</para>
|
||||||
|
|
||||||
<para>Container system, boot system and library changes are some examples of the
|
<para>Container system, boot system and library changes are some examples of the
|
||||||
pull requests fitting this category.</para>
|
pull requests fitting this category.</para>
|
||||||
|
|
||||||
</section>
|
</section>
|
||||||
|
|
||||||
<section><title>Merging pull-requests</title>
|
<section><title>Merging pull-requests</title>
|
||||||
|
|
||||||
<para>It is possible for community members that have enough knowledge and
|
<para>It is possible for community members that have enough knowledge and
|
||||||
experience on a special topic to contribute by merging pull requests.</para>
|
experience on a special topic to contribute by merging pull requests.</para>
|
||||||
|
|
||||||
<para>TODO: add the procedure to request merging rights.</para>
|
<para>TODO: add the procedure to request merging rights.</para>
|
||||||
|
|
@ -380,13 +380,13 @@ The following paragraph about how to deal with unactive contributors is just a
|
||||||
proposition and should be modified to what the community agrees to be the right
|
proposition and should be modified to what the community agrees to be the right
|
||||||
policy.
|
policy.
|
||||||
|
|
||||||
<para>Please note that contributors with commit rights unactive for more than
|
<para>Please note that contributors with commit rights unactive for more than
|
||||||
three months will have their commit rights revoked.</para>
|
three months will have their commit rights revoked.</para>
|
||||||
-->
|
-->
|
||||||
|
|
||||||
<para>In a case a contributor leaves definitively the Nix community, he should
|
<para>In a case a contributor leaves definitively the Nix community, he should
|
||||||
create an issue or notify the mailing list with references of packages and
|
create an issue or notify the mailing list with references of packages and
|
||||||
modules he maintains so the maintainership can be taken over by other
|
modules he maintains so the maintainership can be taken over by other
|
||||||
contributors.</para>
|
contributors.</para>
|
||||||
|
|
||||||
</section>
|
</section>
|
||||||
|
|
|
||||||
|
|
@ -130,7 +130,7 @@ Note: the use of <literal>services.xserver.synaptics</literal> is deprecated sin
|
||||||
<simplesect><title>GTK/Qt themes</title>
|
<simplesect><title>GTK/Qt themes</title>
|
||||||
|
|
||||||
<para>GTK themes can be installed either to user profile or system-wide (via
|
<para>GTK themes can be installed either to user profile or system-wide (via
|
||||||
<literal>system.environmentPackages</literal>). To make Qt 5 applications look similar
|
<literal>environment.systemPackages</literal>). To make Qt 5 applications look similar
|
||||||
to GTK2 ones, you can install <literal>qt5.qtbase.gtk</literal> package into your
|
to GTK2 ones, you can install <literal>qt5.qtbase.gtk</literal> package into your
|
||||||
system environment. It should work for all Qt 5 library versions.
|
system environment. It should work for all Qt 5 library versions.
|
||||||
</para>
|
</para>
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue