about summary refs log tree commit diff
path: root/doc
diff options
context:
space:
mode:
authorMartin Weinelt <hexa@darmstadt.ccc.de>2023-02-24 23:15:52 +0100
committerMartin Weinelt <mweinelt@users.noreply.github.com>2023-02-27 02:21:07 +0000
commit0d09b95ad1b156336e566a639d085a11e18f061b (patch)
tree50cc7051eb824d4a7fc056bd35b2209c04e636cf /doc
parentc4ee7b8f6213a2d67d9dcac23c43a0e93e1aae74 (diff)
doc/python: Explain opt-out out of bulk updates
Diffstat (limited to 'doc')
-rw-r--r--doc/languages-frameworks/python.section.md5
1 files changed, 5 insertions, 0 deletions
diff --git a/doc/languages-frameworks/python.section.md b/doc/languages-frameworks/python.section.md
index c1945adb1cd30..dd61aa26ce408 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.