• Bug#1109323: developers-reference: extend documentation of delayed/defe

    From Lucas Nussbaum@21:1/5 to All on Tue Jul 15 08:50:01 2025
    XPost: linux.debian.policy

    Package: developers-reference
    Version: 13.20
    Severity: wishlist
    X-Debbugs-Cc: [email protected]

    Hi,

    The delayed/deferred queue mechanism is documented in section 5.6.3
    (Delayed uploads). However https://lists.debian.org/debian-devel-announce/2008/09/msg00006.html has
    more details about queue handling, that should be integrated in developers-reference.

    I will try to provide a patch/MR, but feel free to beat me to it.

    Lucas

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From =?UTF-8?B?T3R0byBLZWvDpGzDpGluZW4=?@21:1/5 to All on Tue Jul 15 12:10:01 2025
    XPost: linux.debian.policy

    +1 to clarifying the DELAYED queue section. Please also include an
    example dcut command on how to remove a package from the DELAYED queue
    if the maintainer does not want to have it.

    Personally I would much rather see a contribution being submitted to
    my packages as a Merge Request on Salsa, than as a NMU via DELAYED. If
    I am active, I can immediately engage in discussion about the change.
    If I am really busy I can just merge it without discussion, or comment
    that I am fine with it but don't have time to review deeper. If I am
    completely missing, I would be fine if somebody posted a MR and then
    after a few weeks went and merged it themselves and uploaded. This
    would still feel more collaborative than noticing a new package
    version as NMU in DELAYED. Does this resonate with others?

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Sean Whitton@21:1/5 to All on Tue Jul 15 12:50:01 2025
    XPost: linux.debian.policy

    Hello,

    On Tue 15 Jul 2025 at 12:03pm +02, Otto Kekäläinen wrote:

    +1 to clarifying the DELAYED queue section. Please also include an
    example dcut command on how to remove a package from the DELAYED queue
    if the maintainer does not want to have it.

    Personally I would much rather see a contribution being submitted to
    my packages as a Merge Request on Salsa, than as a NMU via DELAYED. If
    I am active, I can immediately engage in discussion about the change.
    If I am really busy I can just merge it without discussion, or comment
    that I am fine with it but don't have time to review deeper. If I am completely missing, I would be fine if somebody posted a MR and then
    after a few weeks went and merged it themselves and uploaded. This
    would still feel more collaborative than noticing a new package
    version as NMU in DELAYED. Does this resonate with others?

    Yeah, me too (though I'd prefer a BTS bug to an MR, but it's the same).

    The thing about DELAYED is that it's fire-and-forget for the contributor actually doing the work, which is an advantage.

    --
    Sean Whitton

    --=-=-Content-Type: application/pgp-signature; name="signature.asc"

    -----BEGIN PGP SIGNATURE-----

    iQJNBAEBCgA3FiEEm5FwB64DDjbk/CSLaVt65L8GYkAFAmh2MLUZHHNwd2hpdHRv bkBzcHdoaXR0b24ubmFtZQAKCRBpW3rkvwZiQK+fD/45gt3Cazbsh+FedQSG2FDV ywvsGB2wXw8OBnCJ3nMM4WSGe7P2ULk6F608wmcGiTaWwEpGDzlXXENLZSBrY0Js uCvvCHhV8g8ME3umcUzTLRUd1Sp9zjfElK6c7g/TW3uZib5dEX40vIcOmkRMupX5 DjXoZQzrTaOcdB+SmZM58iVCuuVZ0EEUyk+Vs4+pJqNxRBeRwyhjyBqfUR0exxek PQx8TyD3LpcqcWJTiWYfhoGlk4C8HAQrJWgRH7u3zGM6sib88w8jW0Fyw7RfNI5Q U2g+ENALq1wRUTt8lFjSXo1DovoZYGgXMqpWH23ME25RgbvNkDtyfvKms/b+hFG5 QI0XAH6T+kfVyLdxJ7MI0L+IFrKBssP5xPQQ0pnAZ9PcJ+b0jMfbQM0U8mviXOAA NNyeTe8l58V0kZTQrH7v2PSFWas6fp5x4mEUsXjAkXcF6kL4AJTkzb8QVJ4OUDde FCKNMGk5bngDOC9/OCAG2uQqhidRSUlDg9kFniRZAVUYHHyU7X3zwvSMhvob6BmB Vp3CUYWUfeD158WTTHIt9/Mo1bXthlfIbFMZoA9xT0shBN3pbnXUaXJ1x7fB2LDD H0P2/fxI/PM88LD+TRO5MYOXQ10U9Ee1amMqYHL3xsKrspdrQI6p7LsjsgT3UTa5 NIioJbo/GbB0w3m6v0LkQw==ztF5
    -----END PGP SIGNATURE-----

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Us
  • From Simon McVittie@21:1/5 to Sean Whitton on Tue Jul 15 15:40:02 2025
    XPost: linux.debian.policy

    On Tue 15 Jul 2025 at 12:03pm +02, Otto Kek�l�inen wrote:
    If I am
    completely missing, I would be fine if somebody posted a MR and then
    after a few weeks went and merged it themselves and uploaded. This
    would still feel more collaborative than noticing a new package
    version as NMU in DELAYED. Does this resonate with others?

    Expanding a little on what Sean said, let's suppose your foobar_1.2-3
    package has a sufficiently bad bug to justify a NMU, and I have some
    time available and I want to fix that bug.

    What I would often want to do as the contributor, if I have limited
    time, is:

    * ensure there is a bug open with a solution-neutral problem statement
    about the bug I'm fixing (open it if necessary)
    * make and test the change
    * send a MR (and/or a patch in email), either versioned as
    "1.2-4 (UNRELEASED)" or without touching the changelog at all, with
    the change that I'm proposing you should make
    * mention in the bug/MR that I'm going to NMU it to DELAYED to make sure
    that a fix will land in a timely way
    * locally adjust the changelog to be a NMU versioned as 1.2-3.1 or
    1.2-3+nmu1, and build and re-test it
    * upload my NMU to some appropriate DELAYED queue
    * send the nmudiff to the bug because devref says I must, but point to
    the MR as the "canonical" version

    That way, if neither you nor I act on it further because we're both
    busy, the "default" will be that my NMU reaches the archive a few days
    later and the bug gets fixed; and getting a fix into the archive doesn't
    depend on me remembering to come back to this bug several days later, by
    which time I might have become distracted by some other priority.

    If one of us *does* have time later, the maintainer can preempt the
    DELAYED change by either converting it into a higher-version-numbered maintainer upload if they approve, or uploading a better solution if
    they do not approve; or the other contributor can cancel their delayed
    NMU if it becomes clear that it shouldn't be accepted, or re-upload
    without delay if they're given permission to do so (or even without
    permission, if they find out that fixing the bug is more urgent than
    they had previously thought).

    Hopefully that's a workflow that everyone could be reasonably happy with?

    If I happen to have the time available at the time that my delayed NMU
    hits the archive, *then* I could optionally come back and merge the MR (although I would personally tend to just update it with the NMU's
    changelog entry at that point, leaving it up to the maintainer whether
    they want to merge it as-is or do something completely different,
    because that way the maintainer gets to control their package's
    "official" history).

    went and merged it themselves

    The contributor doesn't necessarily have commit/merge access to every
    repo where they might find themselves stepping in and fixing a nasty bug (especially if they are a non-DD who needs to get their NMU sponsored),
    but they certainly have the ability to send patches-in-email, and
    hopefully MRs as well.

    On Tue, 15 Jul 2025 at 11:43:01 +0100, Sean Whitton wrote:
    The thing about DELAYED is that it's fire-and-forget for the contributor >actually doing the work, which is an advantage.

    I agree that when the contributor doing the work can only spend a
    limited amount of time and attention on it, there is value in grouping
    together all of the work to be done the same day (make the change, send
    to BTS, send MR if desired, upload to DELAYED) so that in the absence of
    any other action being taken, the proposed fix will reach the archive
    without the contributor needing to actively herd it through the process.

    I'm not sure that I see a situation where it would be rational to use
    DELAYED, but unacceptably slow to open BTS bugs or MRs?

    For any upload to DELAYED, I would usually expect a bug in the BTS
    whatever else happens: an uploader should only use DELAYED in cases
    where it's acceptable for there to be a delay of a few days before the
    fix actually reaches the archive, and if that's the case then opening a
    BTS bug before uploading is not going to have a significant impact on
    the time-to-fix. I'd personally prefer the actual proposed change to be
    in the form of a MR rather than patches-in-email, but I think there's
    often value in reporting a solution-neutral problem statement to the BTS
    before (or at the same time as) proposing a solution, because sometimes
    the first solution proposed is not actually the best answer to the
    stated problem, and we should make it as easy as possible for a
    maintainer to be able to say "yes, this is a good solution" or "no, this
    isn't a good solution" (or even "no, this isn't a valid bug").

    In cases where the time taken to open a BTS bug or a MR would be
    unacceptable, like a very bad regression or an actively-exploited
    security vulnerability, surely the time delay of DELAYED would not be acceptable either? In this case I'd expect the uploader to NMU first
    (very carefully!) without using DELAYED, and then open a BTS bug with
    the nmudiff afterwards, again accompanied by a MR if they're feeling
    helpful.

    smcv

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Sean Whitton@21:1/5 to Simon McVittie on Tue Jul 15 16:40:01 2025
    XPost: linux.debian.policy

    Hello,

    On Tue 15 Jul 2025 at 02:33pm +01, Simon McVittie wrote:

    On Tue, 15 Jul 2025 at 11:43:01 +0100, Sean Whitton wrote:
    The thing about DELAYED is that it's fire-and-forget for the contributor >>actually doing the work, which is an advantage.

    I agree that when the contributor doing the work can only spend a limited amount of time and attention on it, there is value in grouping together all of
    the work to be done the same day (make the change, send to BTS, send MR if desired, upload to DELAYED) so that in the absence of any other action being taken, the proposed fix will reach the archive without the contributor needing
    to actively herd it through the process. I'm not sure that I see a situation where it would be rational to use DELAYED, but unacceptably slow to open BTS bugs or MRs?

    It's not about speed, but about being able to set the bug aside.
    I.e., the "forget" is the key word. I track everything meticulously in Org-mode tasks but many volunteers are keen not to have personal to-do
    lists for work done in their free time. Fire-and-forget enables that.

    --
    Sean Whitton

    --=-=-Content-Type: application/pgp-signature; name="signature.asc"

    -----BEGIN PGP SIGNATURE-----

    iQJNBAEBCgA3FiEEm5FwB64DDjbk/CSLaVt65L8GYkAFAmh2YyAZHHNwd2hpdHRv bkBzcHdoaXR0b24ubmFtZQAKCRBpW3rkvwZiQDZRD/4vNyLohAc9j0ijhmW0zuTi dlycW2pcI6whG3DWTPkGrPIKcg41qkNdTlHWcNrk6S/9lMa6BNApoV8Yd3sixxmJ aJzdFvd6kv07CidLbDPjieMwdIM5Pdl8ye6dIpAYWo3YB7hbMixDY1FbyA+fYVjo 6NMdFVIIpe6XoGJZT+YLyGHVAlf3m9VjuXwL83S4QLqwt25yW6nDRfCg1EnPguMO sbCTWePFF7iS5m71Jm+1qJu4p2LUVfKtYUHJcxKSRnMh4xOBduQABMk+bty7e8r+ WuZXLKmUG0XI9wYniDExZPWtdrNPS7Nd1+oEE1nvd1ogcvoMtNXWU5nNEwxTr8yU Lg7UyxnP6MDxxS3fdC83/CsDtswleMIP+QLI+Ld0IWfGImoKHhrgOUPcJEvqD/UH I5ZXpGmD6ecWED/Avdlmq0ADiwpixKOzu/kC5NWC+iwut71a73ZloL+BBVlnRd4X K9J4UgtTpp3JJIpHjOgkNqyFwpl0EOb1rug8J/M12JT39JMILiRjk4lhg/jxBxwG IF85kESGWJKEc9VPpZ/8WL3ugnOXlCbduYGUcTy5fs/xVFYDIT5mynw4D5WXWUuc BZHypBAF6YY2aCMIdoTVfSGI0CHmQmQ43UgwlkXir63gFItxR3gpFJ6LE8eXFGPq ard6FV/tuOiy/Erq/FrXqg==g8Yo
    -----END PGP SIGNATURE-----

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Us
  • From Holger Levsen@21:1/5 to Sean Whitton on Tue Jul 15 18:00:01 2025
    XPost: linux.debian.policy

    On Tue, Jul 15, 2025 at 11:43:01AM +0100, Sean Whitton wrote:
    Yeah, me too (though I'd prefer a BTS bug to an MR, but it's the same).

    I definitly prefer an MR for such a change.

    (For more controversial changes I prefer to have a BTS track record, because salsa can go away, while the BTS will stay with us forever...)


    --
    cheers,
    Holger

    ⢀⣴⠾⠻⢶⣦⠀
    ⣾⠁⢠⠒⠀⣿⡁ holger@(debian|reproducible-builds|layer-acht).org
    ⢿⡄⠘⠷⠚⠋⠀ OpenPGP: B8BF54137B09D35CF026FE9D 091AB856069AAA1C
    ⠈⠳⣄

    "I became an antifascist out of a sense of common decency.” – Marlene Dietrich

    -----BEGIN PGP SIGNATURE-----

    iQIzBAABCgAdFiEEuL9UE3sJ01zwJv6dCRq4VgaaqhwFAmh2emwACgkQCRq4Vgaa qhxovg/+OuRhxiB35PHkKouoAja+048k1tsm33YLl0FOvHYfi5mCMNO4lW+GdvRB +czVrxVpqaZvxOEN2WB0x0hevkkX7GmEovvMW6OMsQMPKNsUVU4HVFa8xYGJOQ5N 3vqxy0NA9Fu3V2txMFJc2P85JeEGoYW3D0VA5nVhbcCbjfHUqw26gN++NLpZp4Y0 uELjbyhaLveY23Momlw/xzmEuAUIBsqMnKr7w2AW3YUNYFj4aU4AT6apOaMWTMcA +S/cmcT3BNeE73wz89SSoxj6xhdcwHWSH53SvcEZFhLMqXMLwWyrn+QbTGjRTSxD Sr1wuo87uzt2VTTi3KeouhZft9yU5/2i49BZ7p+nu3kD3W4Jw+xyQIdyhdtl3raB 3EL0lCz++dVkWpX/mlHMM+mexeIV0wKd6+mkDxjnJ8KGh6qHs3L7/US6bS0VlQYq 0v3YMjby+e+2tRKrJq+evTKJX9wF1CMjDb4DMlgBX7KOgXge11miP9Z9SSrjw3vn QEeuOgtn5mlD6jfDZ+M4lL/W7Jkht5uY2kHJ7O8GgIRxJ+Wy8saeboCCGPMJ3d+R b8cEi4ZRnEXOmEKTNk2NFiBCkjkgvN
  • From Lucas Nussbaum@21:1/5 to All on Tue Jul 15 18:00:01 2025
    XPost: linux.debian.policy

    On 15/07/25 at 12:03 +0200, Otto Kek�l�inen wrote:
    +1 to clarifying the DELAYED queue section. Please also include an
    example dcut command on how to remove a package from the DELAYED queue
    if the maintainer does not want to have it.

    Right

    Personally I would much rather see a contribution being submitted to
    my packages as a Merge Request on Salsa, than as a NMU via DELAYED. If
    I am active, I can immediately engage in discussion about the change.
    If I am really busy I can just merge it without discussion, or comment
    that I am fine with it but don't have time to review deeper. If I am completely missing, I would be fine if somebody posted a MR and then
    after a few weeks went and merged it themselves and uploaded. This
    would still feel more collaborative than noticing a new package
    version as NMU in DELAYED. Does this resonate with others?

    Maybe it would be better to focus this bug for discussing how to improve
    the section of developers-reference that describes DELAYED queue
    handling, and move the discussion about MR-based workflows elsewhere?

    We can improve the current process and discuss a new process at the same
    time (in different fora), and drop the current process when the new
    process is ready and widely accepted.

    Lucas

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Lucas Nussbaum@21:1/5 to Holger Levsen on Tue Jul 15 18:30:01 2025
    XPost: linux.debian.policy

    On 15/07/25 at 15:57 +0000, Holger Levsen wrote:
    On Tue, Jul 15, 2025 at 11:43:01AM +0100, Sean Whitton wrote:
    Yeah, me too (though I'd prefer a BTS bug to an MR, but it's the same).

    I definitly prefer an MR for such a change.

    (For more controversial changes I prefer to have a BTS track record, because salsa can go away, while the BTS will stay with us forever...)

    I think that Otto and Sean are discussing the merits of DELAYED vs MR vs
    bugs for NMU-like contributions, while you are discussing how this
    particular contribution (improving doc) should be handled.

    Lucas

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Holger Levsen@21:1/5 to Lucas Nussbaum on Tue Jul 15 19:10:01 2025
    XPost: linux.debian.policy

    On Tue, Jul 15, 2025 at 06:16:40PM +0200, Lucas Nussbaum wrote:
    I think that Otto and Sean are discussing the merits of DELAYED vs MR vs
    bugs for NMU-like contributions, while you are discussing how this
    particular contribution (improving doc) should be handled.

    ah, lol, thanks Lucas. Please ignore what I said then :)

    that said, me likes NMUs via DELAYED.


    --
    cheers,
    Holger

    ⢀⣴⠾⠻⢶⣦⠀
    ⣾⠁⢠⠒⠀⣿⡁ holger@(debian|reproducible-builds|layer-acht).org
    ⢿⡄⠘⠷⠚⠋⠀ OpenPGP: B8BF54137B09D35CF026FE9D 091AB856069AAA1C
    ⠈⠳⣄

    Never waste a crisis.

    -----BEGIN PGP SIGNATURE-----

    iQIzBAABCgAdFiEEuL9UE3sJ01zwJv6dCRq4VgaaqhwFAmh2idMACgkQCRq4Vgaa qhxFeQ//TkzKsA2c2Ur5zxsV80GrLQDcL295baaOLwW7Bj2s9SYGE7a2NsmO+KHJ rcveIoP43O2cwo5A3hpiw3tfgYsM44moOex2KkwlJ6g+S0RYr/Yf8fNUKwlv0Zvz BJx0yVHIIbOj00XwFF+K2YFfb7Fxj5JjrOjMdDvjGwgWAIQ0jbTZGktVAofSHYm1 HgYhDnLeu6eA5RBEc3QPZdZ2ATkjE3eMdzbrXZuyS89XWfFSXJuMO+Kr0ryahF8S 85VsZ/kzqMl4uZ7qc+sKRx5s76hBy8ydIUHWr1xgRkBdtzVPzo/+XUNxBc9jxrgZ 0gvO3B8az1TZdgmAKVJsdpyaW37Iqx4kW0j57H8MrfLIxAg9tC/Fw2MbIO6drCjD 2qVz86z5cVJPzefZLhJCi0JqhE2lL1vewCPmJxhW5hvjcBjui3E+fXnpES/FoIiN UEKHpYrlLhrLnGWmH7Yad33eZxtuHNJEnmAVlwojB2RauCiq2M/J/xPPJedoFEw3 rJi5u7NTq1UabwtMB0kvUzMxQ5/NuMnGgJbr05SBnLwqieDRe0nzbPl6NKWzJ4aE RXxGbRZcE2Eem8UQbhG6aiCbLSbaPxMBUrvchUtoPLFY2KO+9xKCVDSjAOmYQFEu +9/z84kZ5oCaqcTFFWPlAp9IN
  • From Simon McVittie@21:1/5 to Sean Whitton on Tue Jul 15 20:50:01 2025
    XPost: linux.debian.policy

    On Tue, 15 Jul 2025 at 15:18:08 +0100, Sean Whitton wrote:
    It's not about speed, but about being able to set the bug aside.

    Yes, I was agreeing with you - like I said, grouping together all the
    work into one "transaction" has value, and DELAYED enables that.

    On Tue 15 Jul 2025 at 02:33pm +01, Simon McVittie wrote:
    I'm not sure that I see a situation
    where it would be rational to use DELAYED, but unacceptably slow to open BTS >> bugs or MRs?

    When I said "unacceptably slow" I meant something more like latency
    rather than time taken: it seemed to me as though there was a suggestion
    that we should be choosing between proposing MRs (or patches) *or* doing
    a delayed NMU, but in the scenarios where DELAYED is relevant, I'd prefer contributors to consider sending a MR (or patch) *and* doing a delayed NMU.

    smcv

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Sean Whitton@21:1/5 to Simon McVittie on Tue Jul 15 23:00:01 2025
    XPost: linux.debian.policy

    Hello,

    On Tue 15 Jul 2025 at 07:43pm +01, Simon McVittie wrote:

    On Tue, 15 Jul 2025 at 15:18:08 +0100, Sean Whitton wrote:
    It's not about speed, but about being able to set the bug aside.

    Yes, I was agreeing with you - like I said, grouping together all the work into one "transaction" has value, and DELAYED enables that.

    On Tue 15 Jul 2025 at 02:33pm +01, Simon McVittie wrote:
    I'm not sure that I see a situation
    where it would be rational to use DELAYED, but unacceptably slow to open BTS
    bugs or MRs?

    When I said "unacceptably slow" I meant something more like latency rather than time taken: it seemed to me as though there was a suggestion that we should be choosing between proposing MRs (or patches) *or* doing a delayed NMU, but in the scenarios where DELAYED is relevant, I'd prefer contributors to consider sending a MR (or patch) *and* doing a delayed NMU.

    Right. Sounds like we don't disagree at all.

    --
    Sean Whitton

    --=-=-Content-Type: application/pgp-signature; name="signature.asc"

    -----BEGIN PGP SIGNATURE-----

    iQJNBAEBCgA3FiEEm5FwB64DDjbk/CSLaVt65L8GYkAFAmh2wFEZHHNwd2hpdHRv bkBzcHdoaXR0b24ubmFtZQAKCRBpW3rkvwZiQFy6EACaLBoOxvDUeFdVN4dcXazM fBYei9d5dVVMtWWmiAXQPS7xdtSMspFMrjqyxvStcUArONBFYe5BCTtSa7cQlPZ6 Ah4KdzRvD6+D+3J8VK5oS9hLI7S+vQvVMfaQsGhuvcXttIIj9rhBeQqNkZFcYW7K LaKVWvBqZpufTB3WCCnwuKywBfeXwuaFEEQGAPjeLBmKJjRh9J/PNEgrt2x91WEy ktkW40IS7sTzyutx32+lZVul0QN8mfiMAUqc9bmKmWd13z+6JLsxlfyE8XPltwyU cm2RrwSzrqGHsiUOabEv4mK9W9Ypmr4lH83rqO9vOJeo7OzC0UFla3RNJN9WsByG LgXFwYiDrwhMb2AI1PICO2Nrs9EZmk/ZHVaW1H1eS2T3Zi/idESv574o3ShFoqy1 UwkjNUvBpjwZF+o+YyNCP53xE/tTy7vpxz6sq7DHoHZjoXB3UvBlgl1ZMjiZMePQ BurecMkEmoo4xzjRuxrgnxIjRe6BWJIa6alt5S00IFAryaR4kTZauHl7dHVUKfV5 sqhoHQW5vx5X2mlyiSJESmQsWd7Yg+DsHW3hAMmR/vOw59wW5/aFcsg3pgGgkClc 2TOCcNJYOsXODMt5ABvVUU6x7E0FyzagQeKa6RtZ4YpYzMWdWMv0PVP6wWPJm2SB 1czZYUPQe8Hyx3jPnu+LWQ==CoK7
    -----END PGP SIGNATURE-----

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Us