doc/python: Explain opt-out out of bulk updates

This commit is contained in:
Martin Weinelt 2023-02-24 23:15:52 +01:00 committed by Martin Weinelt
parent c4ee7b8f62
commit 0d09b95ad1

View File

@ -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.