From 0d09b95ad1b156336e566a639d085a11e18f061b Mon Sep 17 00:00:00 2001 From: Martin Weinelt Date: Fri, 24 Feb 2023 23:15:52 +0100 Subject: [PATCH] doc/python: Explain opt-out out of bulk updates --- doc/languages-frameworks/python.section.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/doc/languages-frameworks/python.section.md b/doc/languages-frameworks/python.section.md index c1945adb1cd..dd61aa26ce4 100644 --- a/doc/languages-frameworks/python.section.md +++ b/doc/languages-frameworks/python.section.md @@ -1821,6 +1821,11 @@ hosted on GitHub, exporting a `GITHUB_API_TOKEN` is highly recommended. Updating packages in bulk leads to lots of breakages, which is why a stabilization period on the `python-unstable` branch is required. +If a package is fragile and often breaks during these bulks updates, it +may be reasonable to set `passthru.skipBulkUpdate = true` in the +derivation. This decision should not be made on a whim and should +always be supported by a qualifying comment. + Once the branch is sufficiently stable it should normally be merged into the `staging` branch.