From 6ed55034eec21f50c33afe7b4c4f5c13d49eba72 Mon Sep 17 00:00:00 2001 From: Jonathan Ringer Date: Thu, 3 Sep 2020 23:42:30 -0700 Subject: [PATCH] doc/python: reword sorting gaurentee to be stronger --- doc/languages-frameworks/python.section.md | 7 ++++--- 1 file 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//default.nix`. Libraries in - `pkgs/top-level/python-packages.nix` are sorted quasi-alphabetically to avoid - merge conflicts. + `pkgs/development/python-modules//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.