summaryrefslogtreecommitdiffstats
path: root/doc/contributing/coding-conventions.xml
diff options
context:
space:
mode:
Diffstat (limited to 'doc/contributing/coding-conventions.xml')
-rw-r--r--doc/contributing/coding-conventions.xml6
1 files changed, 6 insertions, 0 deletions
diff --git a/doc/contributing/coding-conventions.xml b/doc/contributing/coding-conventions.xml
index cb6d60c2c138..9005a9ebafd6 100644
--- a/doc/contributing/coding-conventions.xml
+++ b/doc/contributing/coding-conventions.xml
@@ -180,6 +180,12 @@ args.stdenv.mkDerivation (args // {
</listitem>
<listitem>
<para>
+ Arguments should be listed in the order they are used, with the
+ exception of <varname>lib</varname>, which always goes first.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
Prefer using the top-level <varname>lib</varname> over its alias
<literal>stdenv.lib</literal>. <varname>lib</varname> is unrelated to
<varname>stdenv</varname>, and so <literal>stdenv.lib</literal> should only