doc: Update the developer mailing list address. #29782

pull edilmedeiros wants to merge 1 commits into bitcoin:master from edilmedeiros:fix-mailing-link changing 2 files +3 −2
  1. edilmedeiros commented at 9:21 pm on April 1, 2024: contributor

    The developer mailing list was migrated to Google Groups in February 2024 as announced in https://groups.google.com/g/bitcoindev/c/aewBuV6k-LI.

    In this patch, I decided to add a link to the archives maintained by the Linux Foundation as linked in the old mailing list page.

    A reasonable alternative would be link to the new archives linked in the migration announcement message. I’m not sure about the status of the archive migration, probably the old archives are more comprehensive to this date.

  2. DrahtBot commented at 9:21 pm on April 1, 2024: contributor

    The following sections might be updated with supplementary metadata relevant to reviewers and maintainers.

    Code Coverage

    For detailed information about the code coverage, see the test coverage report.

    Reviews

    See the guideline for information on the review process.

    Type Reviewers
    ACK Zero-1729, josibake, Sjors

    If your review is incorrectly listed, please react with 👎 to this comment and the bot will ignore it on the next update.

  3. DrahtBot added the label Docs on Apr 1, 2024
  4. edilmedeiros commented at 9:27 pm on April 1, 2024: contributor

    The old mailing list address is also mentioned in https://github.com/bitcoin/bitcoin/blob/23ba39470c3d155a65f0616f8848ada730658301/doc/dnsseed-policy.md?plain=1#L47

    Would be a good idea to address that as well?

    All other references to the old Linux Foundation mailing list in the code base link to specific threads in the archives and all links are active to this date.

  5. DrahtBot added the label CI failed on Apr 2, 2024
  6. in CONTRIBUTING.md:72 in 30a54f70f2 outdated
    65@@ -66,9 +66,10 @@ Discussion about codebase improvements happens in GitHub issues and pull
    66 requests.
    67 
    68 The developer
    69-[mailing list](https://lists.linuxfoundation.org/mailman/listinfo/bitcoin-dev)
    70+[mailing list](https://groups.google.com/g/bitcoindev)
    71 should be used to discuss complicated or controversial consensus or P2P protocol changes before working on
    72 a patch set.
    73+Archives can be found in the [old mailing list](https://lists.linuxfoundation.org/pipermail/bitcoin-dev/) maintained by the Linux Foundation.
    


    josibake commented at 8:41 am on April 2, 2024:
    Probably best to use the new archive link throughout

    Sjors commented at 1:47 pm on April 2, 2024:

    For links to the full archive and for the signup feature that seems fine.

    But for links to specific threads (6 in total) I suggest we keep the old URL. At least for a few more years. They are redirected indefinitely, and not changing those links gives flexibly to switch to different archive later with or without generating a complete set of redirects.


    Sjors commented at 1:51 pm on April 2, 2024:

    Also, looking at https://gnusha.org/pi/bitcoindev/ the layout is not very pretty. So even for the old archive I would prefer sticking to the linuxfoundation URL. But the text should clarify that this archive goes until December 2023.

    (and I don’t think Google itself should be recommended as the canonical archive)


    edilmedeiros commented at 4:01 pm on April 2, 2024:

    Also, looking at https://gnusha.org/pi/bitcoindev/ the layout is not very pretty. So even for the old archive I would prefer sticking to the linuxfoundation URL. But the text should clarify that this archive goes until December 2023.

    (and I don’t think Google itself should be recommended as the canonical archive)

    I wasn’t aware the Linux Foundation archive were not being updated anymore. It means that the new archive is the comprehensive source of truth in the present and probably is the best option. But I don’t like the idea of having Google as the main source as well.

  7. josibake commented at 8:42 am on April 2, 2024: member

    Concept ACK, thanks for updating this!

    In this patch, I decided to add a link to the archives maintained by the Linux Foundation as linked in the old mailing list page.

    I’m not sure about this. I don’t think there is any expectation this archive will be maintained.

    All other references to the old Linux Foundation mailing list in the code base link to specific threads in the archives and all links are active to this date.

    I think it would be better to switch all links over to the new archive. AFAIK, the archive migration is complete and matches the old archive, so I don’t see any issues with switching all the links over. As a sanity check, we can spot check the URLs as part of review.

  8. kanzure commented at 2:08 pm on April 2, 2024: contributor

    I’m not sure about the status of the archive migration, probably the old archives are more comprehensive to this date. […] AFAIK, the archive migration is complete and matches the old archive, so I don’t see any issues with switching all the links over.

    The archive migration to https://gnusha.org/pi/bitcoindev was completed, and it is a complete record at this time, including new messages to the new mailing list.

    the layout is not very pretty

    Well…. pull requests welcome. This is a public-inbox instance. See https://public-inbox.org/ for more information. Also, mirrors of this archive would also be very much welcome. Give it a spiffy url that people will remember, and then it won’t be a single point of failure. It’s just git, so git clone it.

    All other references to the old Linux Foundation mailing list in the code base link to specific threads in the archives and all links are active to this date. […] I don’t think there is any expectation this archive will be maintained.

    The old linuxfoundation archive and urls I am told will continue to host the old emails. It will not have any of the new emails of course.

    They are redirected indefinitely.

    I haven’t heard about this?

    (and I don’t think Google itself should be recommended as the canonical archive)

    Agree.

  9. Sjors commented at 2:42 pm on April 2, 2024: member

    They are redirected indefinitely.

    I haven’t heard about this?

    I meant to say for the foreseeable future. Or did they announce a deadline for these?

    Update: not redirect, but a static page.

  10. edilmedeiros commented at 4:11 pm on April 2, 2024: contributor

    @josibake Given the other comments, probably the consensus approach is

    1. to update all mentions of the mailing list to the new link (CONTRIBUTING.md and dnsseed-policy.md),
    2. CONTRIBUTING.md refers to the new archive since this file is the entry point for newcomers,
    3. keep all other mentions of specific emails and threads as they are (as kanzure was told they will still be available in the long term).

    I agree with Sjors to keep the old specific links as they are, that’s why I opened them all before submitting the PR to ensure they are still active.

  11. edilmedeiros commented at 4:17 pm on April 2, 2024: contributor

    For the record, these are the mentions of the linux foundation links:

     0❯ ripgrep linuxfoundation
     1src/validation.cpp
     2962:        // this, see https://lists.linuxfoundation.org/pipermail/bitcoin-dev/2018-November/016518.html
     33960:        // https://lists.linuxfoundation.org/pipermail/bitcoin-dev/attachments/20190225/a27d8837/attachment-0001.pdf).
     44383:        // https://lists.linuxfoundation.org/pipermail/bitcoin-dev/2019-February/016697.html.  Because CheckBlock() is
     5
     6src/crypto/muhash.h
     788: * https://lists.linuxfoundation.org/pipermail/bitcoin-dev/2017-May/014337.html.
     8
     9doc/policy/mempool-limits.md
    1042:post](https://lists.linuxfoundation.org/pipermail/bitcoin-dev/2018-November/016518.html).
    11
    12test/functional/test_framework/crypto/muhash.py
    1321:    See https://cseweb.ucsd.edu/~mihir/papers/inchash.pdf and https://lists.linuxfoundation.org/pipermail/bitcoin-dev/2017-May/014337.html
    14
    15doc/dnsseed-policy.md
    1647:[bitcoin-dev](https://lists.linuxfoundation.org/mailman/listinfo/bitcoin-dev).
    17
    18CONTRIBUTING.md
    1969:[mailing list](https://lists.linuxfoundation.org/mailman/listinfo/bitcoin-dev)
    
  12. josibake commented at 4:18 pm on April 2, 2024: member

    @josibake Given the other comments, probably the consensus approach is

    1. to update all mentions of the mailing list to the new link (CONTRIBUTING.md and dnsseed-policy.md),
    
    2. CONTRIBUTING.md refers to the new archive since this file is the entry point for newcomers,
    
    3. keep all other mentions of specific emails and threads as they are (as kanzure was told they will still be available in the long term).
    

    I agree with Sjors to keep the old specific links as they are, that’s why I opened them all before submitting the PR to ensure they are still active.

    Sounds good to me! I have a slight preference for changing the old links to the new archive since the only thing we are certain of is that the new archive will be maintained going into the future by people closer to the project. But the approach you’ve laid out seems fine and we can always change the old links if/when they become a problem.

  13. edilmedeiros referenced this in commit 754d42d353 on Apr 2, 2024
  14. edilmedeiros force-pushed on Apr 2, 2024
  15. josibake approved
  16. josibake commented at 6:29 pm on April 2, 2024: member
  17. edilmedeiros commented at 6:37 pm on April 2, 2024: contributor

    For future reference, in case we decide to update the archive links cited in other places of the codebase, here is the mapping:

     0src/validation.cpp
     1
     2original: https://lists.linuxfoundation.org/pipermail/bitcoin-dev/2018-November/016518.html
     3update: https://gnusha.org/pi/bitcoindev/c3f68b73-84c6-7428-4bf6-b47802141392@mattcorallo.com/
     4
     5original: https://lists.linuxfoundation.org/pipermail/bitcoin-dev/attachments/20190225/a27d8837/attachment-0001.pdf
     6update: https://gnusha.org/pi/bitcoindev/CAFp6fsGtEm9p-ZQF_XqfqyQGzZK7BS2SNp2z680QBsJiFDraEA@mail.gmail.com/2-BitcoinMerkle.pdf
     7
     8original: https://lists.linuxfoundation.org/pipermail/bitcoin-dev/2019-February/016697.html
     9update: https://gnusha.org/pi/bitcoindev/CAFp6fsGtEm9p-ZQF_XqfqyQGzZK7BS2SNp2z680QBsJiFDraEA@mail.gmail.com/
    10
    1112
    13src/crypto/muhash.h
    14
    15original: https://lists.linuxfoundation.org/pipermail/bitcoin-dev/2017-May/014337.html
    16update: https://gnusha.org/pi/bitcoindev/CAPg+sBgruEiXya6oFy6VpmR1KPDebjeGDtZZU+facZx5=L_a5w@mail.gmail.com/
    17
    1819
    20doc/policy/mempool-limits.md
    21
    22original: https://lists.linuxfoundation.org/pipermail/bitcoin-dev/2018-November/016518.html
    23update: https://gnusha.org/pi/bitcoindev/c3f68b73-84c6-7428-4bf6-b47802141392@mattcorallo.com/
    24
    2526
    27test/functional/test_framework/crypto/muhash.py
    28
    29original: https://lists.linuxfoundation.org/pipermail/bitcoin-dev/2017-May/014337.html
    30update: https://gnusha.org/pi/bitcoindev/CAPg+sBgruEiXya6oFy6VpmR1KPDebjeGDtZZU+facZx5=L_a5w@mail.gmail.com/
    
  18. Update the developer mailing list address.
    The developer mailing list was migrated to Google Groups in February 2024
    as announced in https://groups.google.com/g/bitcoindev/c/aewBuV6k-LI.
    
    The archives maintained by the Linux Foundation stopped updating in December
    2024. Thus, we point to the new archive maintained by gnusha.org.
    
    The codebase refers to old discussions linked to the Linux Foundation archives.
    Since all links are still active to this date, we keep them as they are.
    
    See #29782.
    0ead466a0c
  19. edilmedeiros force-pushed on Apr 2, 2024
  20. edilmedeiros commented at 6:40 pm on April 2, 2024: contributor

    ACK 754d42d

    Excellent commit message 👍

    Thanks, but there was a typo (database instead of codebase). Amended to correct it, sorry for that.

  21. Zero-1729 approved
  22. Zero-1729 commented at 7:12 pm on April 2, 2024: contributor

    crACK 0ead466a0c72bef0a8622749b84e9c7c5c37144f

    LGTM

  23. DrahtBot requested review from josibake on Apr 2, 2024
  24. edilmedeiros requested review from Sjors on Apr 3, 2024
  25. Sjors commented at 7:37 am on April 3, 2024: member
    ACK 0ead466a0c72bef0a8622749b84e9c7c5c37144f
  26. fanquake merged this on Apr 3, 2024
  27. fanquake closed this on Apr 3, 2024

  28. fanquake referenced this in commit 2e59a96485 on Apr 3, 2024
  29. fanquake referenced this in commit fe51aceeca on Apr 4, 2024
  30. fanquake referenced this in commit d82283950f on Apr 15, 2024
  31. kanzure commented at 11:08 pm on November 6, 2024: contributor

    For future reference, in case we decide to update the archive links cited in other places of the codebase, here is the mapping:

    Unfortunately, lists.linuxfoundation.org is no longer hosting any mailing list archives, not just for bitcoin-dev but all the other mailing lists too.

    Are there any particular preferences on doing that proposed replace-all update now that lists.linuxfoundation.org has pulled the content?

    I see a few options here:

    1. Wait and see if they put it back up.

    2. Update those locations in the source code to the proposed new urls like https://gnusha.org/pi/bitcoindev/c3f68b73-84c6-7428-4bf6-b47802141392@mattcorallo.com/ with the Message-ID in the url.

    3. Use https://gnusha.org/url/https://lists.linuxfoundation.org/pipermail/bitcoin-dev/2019-February/016697.html style urls to help others fight web/bit rot for similar links on the web.

    See https://gnusha.org/url for more information about how that works. I made it so that it works as a simple prefix in front of the old format urls.

  32. kanzure referenced this in commit 5ec348d36f on Nov 6, 2024
  33. edilmedeiros commented at 2:18 pm on November 7, 2024: contributor
    Opened #31240 so that we can discuss the best approach to fix this. I’ll check if there are other broken links around.
  34. kanzure referenced this in commit 8bedb5702a on Nov 7, 2024

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: 2024-11-21 09:12 UTC

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