doc: APS explanation clarified in 0.21.0 release notes #20951

pull dscotese wants to merge 1 commits into bitcoin:master from dscotese:patch-1 changing 1 files +3 −4
  1. dscotese commented at 6:16 AM on January 17, 2021: contributor

    There is no point in engaging in partial spends if it costs less to avoid them. The sentence I changed meant that avoiding the partial spend will occur only if the fee is exactly the same, and if avoiding partial spends decreases fees (avoiding does result in a difference), then it won't avoid them, and instead make the higher fee transaction. While it may be impossible for the coin selection algorithm to create a lower fee transaction by avoiding partial spends, the language is now clearer and suggests this rather than leaving the reader to guess.

  2. APS explanation clarified
    There is no point in engaging in partial spends if it costs less to avoid them.  The sentence I changed means that avoiding the partial spend will occur only if the fee is exactly the same, and if avoiding partial spends *decreases* fees (avoiding **does result in a difference**), then it won't avoid them, and instead make a higher fee transaction.  While it may be impossible for the coin selection algorithm to create a lower fee transaction by avoiding partial spends, the language is now clearer and suggests this rather than leaving the reader to guess.
    7052881abc
  3. DrahtBot added the label Docs on Jan 17, 2021
  4. laanwj requested review from achow101 on Jan 19, 2021
  5. laanwj renamed this:
    APS explanation clarified
    doc: APS explanation clarified in 0.21.0 release notes
    on Jan 19, 2021
  6. jonatack commented at 3:27 PM on January 20, 2021: member

    I recall reviewing #14582 by @kallewoof but I'm not sure this version is clearer. Am a bit rushed but will look tomorrow.

  7. kallewoof commented at 7:27 AM on January 21, 2021: member

    There is no point in engaging in partial spends if it costs less to avoid them.

    It never will. The coin selection is less restricted when it is allowed to do partial spends. There will either be exactly the same fee, or the fee will be higher for APS.

    That aside, I'm +/- 0 on your change. The wording changes the perspective from "avoiding partial spends at the expense of slightly increased fees" to "doing partial spend to decrease fees". I think the latter will confuse existing users as to them there is no decrease, only an increase.

    Edit: actually, I do think the "difference" part in the original should be "increase".

  8. jonatack commented at 11:00 AM on January 21, 2021: member

    I prefer the current description that describes the default and agree with s/a difference/an increase/.

  9. laanwj commented at 1:17 PM on February 1, 2021: member

    There doesn't seem to be agreement that the old wording is really in error. The time window for discussing small improvements for the 0.21.0 release notes is reaching its end, I think. By far most people reading these release notes ever will have already read the old version.

    So I'm closing this, sorry.

  10. laanwj closed this on Feb 1, 2021

  11. dscotese commented at 11:04 PM on March 2, 2021: contributor

    It's easy enough for anyone to fix it as @kallewoof and @jonatack suggested, now that the insinuation ("difference" implies that it can be an increase or a decrease) has been clarified as wrong. I understand the "most people ..." argument, but the fact is that the small details that create helpful or harmful insinuations don't matter to most people. They matter to the few who are best positioned to contribute and improve things because they are detail oriented and carefully parse the language. If anyone sees that value, they can make a new PR with the s/a difference/an increase/ change.

    Where can I find a description of "The time window for discussing small improvements for the 0.21.0 release notes"? I should probably pay more attention to my GH notifications.

  12. DrahtBot locked this on Aug 16, 2022


achow101

Labels

github-metadata-mirror

This is a metadata mirror of the GitHub repository bitcoin/bitcoin. This site is not affiliated with GitHub. Content is generated from a GitHub metadata backup.
generated: 2026-04-21 21:14 UTC

This site is hosted by @0xB10C
More mirrored repositories can be found on mirror.b10c.me