summary refs log tree commit diff
path: root/doc/languages-frameworks/python.section.md
diff options
context:
space:
mode:
authorJonathan Ringer <jonringer117@gmail.com>2020-09-03 23:42:30 -0700
committerJonathan Ringer <jonringer@users.noreply.github.com>2021-02-28 16:18:58 -0800
commit6ed55034eec21f50c33afe7b4c4f5c13d49eba72 (patch)
tree2367112a5a809e5c41b144ef0bf8f451f086dd72 /doc/languages-frameworks/python.section.md
parent51bc5783e2e4ee7a39df604c7477a15b9d1185b8 (diff)
downloadnixpkgs-6ed55034eec21f50c33afe7b4c4f5c13d49eba72.tar
nixpkgs-6ed55034eec21f50c33afe7b4c4f5c13d49eba72.tar.gz
nixpkgs-6ed55034eec21f50c33afe7b4c4f5c13d49eba72.tar.bz2
nixpkgs-6ed55034eec21f50c33afe7b4c4f5c13d49eba72.tar.lz
nixpkgs-6ed55034eec21f50c33afe7b4c4f5c13d49eba72.tar.xz
nixpkgs-6ed55034eec21f50c33afe7b4c4f5c13d49eba72.tar.zst
nixpkgs-6ed55034eec21f50c33afe7b4c4f5c13d49eba72.zip
doc/python: reword sorting gaurentee to be stronger
Diffstat (limited to 'doc/languages-frameworks/python.section.md')
-rw-r--r--doc/languages-frameworks/python.section.md7
1 files changed, 4 insertions, 3 deletions
diff --git a/doc/languages-frameworks/python.section.md b/doc/languages-frameworks/python.section.md
index f36f5cf0cbb..46491a785a7 100644
--- a/doc/languages-frameworks/python.section.md
+++ b/doc/languages-frameworks/python.section.md
@@ -1554,9 +1554,9 @@ Following rules are desired to be respected:
 
 * Python libraries are called from `python-packages.nix` and packaged with
   `buildPythonPackage`. The expression of a library should be in
-  `pkgs/development/python-modules/<name>/default.nix`. Libraries in
-  `pkgs/top-level/python-packages.nix` are sorted quasi-alphabetically to avoid
-  merge conflicts.
+  `pkgs/development/python-modules/<name>/default.nix`.
+* Libraries in `pkgs/top-level/python-packages.nix` are sorted
+  alphanumerically to avoid merge conflicts and ease locating attributes.
 * Python applications live outside of `python-packages.nix` and are packaged
   with `buildPythonApplication`.
 * Make sure libraries build for all Python interpreters.
@@ -1570,3 +1570,4 @@ Following rules are desired to be respected:
   [PEP 0503](https://www.python.org/dev/peps/pep-0503/#normalized-names). This
   means that characters should be converted to lowercase and `.` and `_` should
   be replaced by a single `-` (foo-bar-baz instead of Foo__Bar.baz )
+* Attribute names in `python-packages.nix` should be sorted alphanumerically.