📅 Original date posted:2021-04-26
📝 Original message:I endorse Harding's recommendations. On the point about mirroring,
one thing to keep in mind is that the other repositories may go
offline.
Modification confusion could be avoided by recording what revision
(commit hash) was current at the time of inclusion, but the document
going offline can only be protected against by maintaining a copy
somewhere.
On Mon, Apr 26, 2021 at 7:44 PM David A. Harding via bitcoin-dev
<bitcoin-dev at lists.linuxfoundation.org> wrote:
>
> On Sun, Apr 25, 2021 at 05:31:50PM -0400, Matt Corallo via bitcoin-dev wrote:
> > In general, I think its time we all agree the BIP process has simply failed
> > and move on. Luckily its not really all that critical and proposed protocol
> > documents can be placed nearly anywhere with the same effect.
>
> I recommend:
>
> 1. We add additional BIP editors, starting with Kalle Alm (if there are
> no continuing significant objections).
>
> 2. We seek Luke Dashjr's resignation as BIPs editor.
>
> 3. We begin treating protocol documents outside the BIPs repository as
> first-class BIP documentation.
>
> The first recommendation permits continued maintenance of existing BIPs
> plus gives the additional maintainers an opportunity to rebuild the
> credibility of the repository.
>
> The second recommendation addresses the dissatisfaction of many BIP
> authors and potential authors with the current editor, which I think
> will discourage many of them from making additional significant
> contributions to the repository. It also seems to me to be a better use
> of Luke's talents and interests for him to focus on protocol research
> and review rather than procedurally checking whether a bunch of
> documents are well formed.
>
> The third recommendation provides an escape hatch for anyone, such as
> Matt, who currently thinks the process has failed, or for anyone who
> comes to that same conclusion in the future under a different editing
> team. My specific recommendations there are:
>
> a. Anyone writing protocol documentation in the spirit of the BIP
> process can post their idea to this mailing list like we've always
> done and, when they've finished collecting initial feedback, they can
> assign themselves a unique decentralized identifier starting with
> "bip-". They may also define a shorter alias that they encourage
> people to use in cases where the correct document can be inferred
> from context. E.g.,
>
> bip-wuille-taproot (bip-taproot)
> bip-towns-versionbits-min-activation-height (bip-vbmah)
> bip-todd-harding-opt-in-replace-by-fee (bip-opt-in-rbf)
>
> b. The author then publishes the document to any place they'd like, although
> they are strongly encouraged to make any document source available
> under an open license to ensure others can create their own
> modifications.
>
> c. Implementations of BIPs, whether original repository BIPs or
> decentralized BIPs, link to the BIPs they implement to ensure
> researchers and developers can find the relevant protocol
> documentation. E.g.,
> https://github.com/bitcoin/bitcoin/blob/fe5e495c31de47b0ec732b943db11fe345d874af/doc/bips.md
>
> (It may also be advisable for implementations to mirror copies of
> the BIPs they implement so later modifications to the document
> don't confuse anyone. For this reason, extremely liberal
> licensing of BIP documents is encouraged.)
>
> d. To help maintain quality and consistency between documentation, the
> BIP editors provide a BIP document template, guidelines similar to
> the existing BIP2, and an easy-to-run format linter.
>
> I think this decentralized BIPs alternative also helps address some
> longstanding problems with the BIPs system: that many casual Bitcoin
> users and developers think of documents in the BIPs repo as
> authoritative and that there are some development teams (such as for LN)
> that have already abandoned the BIPs process because, in part, they want
> complete control over their own documentation.
>
> The recommendations above were developed based on conversations I had
> with a few stakeholders in the BIPs process, but I did not attempt a
> comprehensive survey and I certainly don't claim to speak for anyone
> else. I hope the recommendations are satisfactory and I look forward to
> your feedback.
>
> Thanks,
>
> -Dave
> _______________________________________________
> bitcoin-dev mailing list
> bitcoin-dev at lists.linuxfoundation.org
> https://lists.linuxfoundation.org/mailman/listinfo/bitcoin-dev
Greg Maxwell [ARCHIVE] /
npub1c9…hzwwn
2023-06-07 22:52:11
in reply to nevent1q…3qmz
Author Public Key
npub1c9wgsqxhgl9fjfsvyflg5tj9rzd78ptkpjjkhmyqghj2r045vyasthzwwnPublished at
2023-06-07 22:52:11Event JSON
{
"id": "7a5de60ec476f37c8452e6b351305c5245d2519cac5ac79726405fbab47065da",
"pubkey": "c15c8800d747ca99260c227e8a2e45189be385760ca56bec8045e4a1beb4613b",
"created_at": 1686178331,
"kind": 1,
"tags": [
[
"e",
"df836c08d17c8829c94bdff4bd50436435b585a258e1227991e1c4e4a55feeb7",
"",
"root"
],
[
"e",
"0d5072c044f65836e50c94fbb7cd889bdc306c71da5c2d778e8c97ada7fcb6b1",
"",
"reply"
],
[
"p",
"d3574a24208f4e3d0821bb4a69a0c3ae842043d444fa5c4a8c49c369918a6fb2"
]
],
"content": "📅 Original date posted:2021-04-26\n📝 Original message:I endorse Harding's recommendations. On the point about mirroring,\none thing to keep in mind is that the other repositories may go\noffline.\n\nModification confusion could be avoided by recording what revision\n(commit hash) was current at the time of inclusion, but the document\ngoing offline can only be protected against by maintaining a copy\nsomewhere.\n\n\nOn Mon, Apr 26, 2021 at 7:44 PM David A. Harding via bitcoin-dev\n\u003cbitcoin-dev at lists.linuxfoundation.org\u003e wrote:\n\u003e\n\u003e On Sun, Apr 25, 2021 at 05:31:50PM -0400, Matt Corallo via bitcoin-dev wrote:\n\u003e \u003e In general, I think its time we all agree the BIP process has simply failed\n\u003e \u003e and move on. Luckily its not really all that critical and proposed protocol\n\u003e \u003e documents can be placed nearly anywhere with the same effect.\n\u003e\n\u003e I recommend:\n\u003e\n\u003e 1. We add additional BIP editors, starting with Kalle Alm (if there are\n\u003e no continuing significant objections).\n\u003e\n\u003e 2. We seek Luke Dashjr's resignation as BIPs editor.\n\u003e\n\u003e 3. We begin treating protocol documents outside the BIPs repository as\n\u003e first-class BIP documentation.\n\u003e\n\u003e The first recommendation permits continued maintenance of existing BIPs\n\u003e plus gives the additional maintainers an opportunity to rebuild the\n\u003e credibility of the repository.\n\u003e\n\u003e The second recommendation addresses the dissatisfaction of many BIP\n\u003e authors and potential authors with the current editor, which I think\n\u003e will discourage many of them from making additional significant\n\u003e contributions to the repository. It also seems to me to be a better use\n\u003e of Luke's talents and interests for him to focus on protocol research\n\u003e and review rather than procedurally checking whether a bunch of\n\u003e documents are well formed.\n\u003e\n\u003e The third recommendation provides an escape hatch for anyone, such as\n\u003e Matt, who currently thinks the process has failed, or for anyone who\n\u003e comes to that same conclusion in the future under a different editing\n\u003e team. My specific recommendations there are:\n\u003e\n\u003e a. Anyone writing protocol documentation in the spirit of the BIP\n\u003e process can post their idea to this mailing list like we've always\n\u003e done and, when they've finished collecting initial feedback, they can\n\u003e assign themselves a unique decentralized identifier starting with\n\u003e \"bip-\". They may also define a shorter alias that they encourage\n\u003e people to use in cases where the correct document can be inferred\n\u003e from context. E.g.,\n\u003e\n\u003e bip-wuille-taproot (bip-taproot)\n\u003e bip-towns-versionbits-min-activation-height (bip-vbmah)\n\u003e bip-todd-harding-opt-in-replace-by-fee (bip-opt-in-rbf)\n\u003e\n\u003e b. The author then publishes the document to any place they'd like, although\n\u003e they are strongly encouraged to make any document source available\n\u003e under an open license to ensure others can create their own\n\u003e modifications.\n\u003e\n\u003e c. Implementations of BIPs, whether original repository BIPs or\n\u003e decentralized BIPs, link to the BIPs they implement to ensure\n\u003e researchers and developers can find the relevant protocol\n\u003e documentation. E.g.,\n\u003e https://github.com/bitcoin/bitcoin/blob/fe5e495c31de47b0ec732b943db11fe345d874af/doc/bips.md\n\u003e\n\u003e (It may also be advisable for implementations to mirror copies of\n\u003e the BIPs they implement so later modifications to the document\n\u003e don't confuse anyone. For this reason, extremely liberal\n\u003e licensing of BIP documents is encouraged.)\n\u003e\n\u003e d. To help maintain quality and consistency between documentation, the\n\u003e BIP editors provide a BIP document template, guidelines similar to\n\u003e the existing BIP2, and an easy-to-run format linter.\n\u003e\n\u003e I think this decentralized BIPs alternative also helps address some\n\u003e longstanding problems with the BIPs system: that many casual Bitcoin\n\u003e users and developers think of documents in the BIPs repo as\n\u003e authoritative and that there are some development teams (such as for LN)\n\u003e that have already abandoned the BIPs process because, in part, they want\n\u003e complete control over their own documentation.\n\u003e\n\u003e The recommendations above were developed based on conversations I had\n\u003e with a few stakeholders in the BIPs process, but I did not attempt a\n\u003e comprehensive survey and I certainly don't claim to speak for anyone\n\u003e else. I hope the recommendations are satisfactory and I look forward to\n\u003e your feedback.\n\u003e\n\u003e Thanks,\n\u003e\n\u003e -Dave\n\u003e _______________________________________________\n\u003e bitcoin-dev mailing list\n\u003e bitcoin-dev at lists.linuxfoundation.org\n\u003e https://lists.linuxfoundation.org/mailman/listinfo/bitcoin-dev",
"sig": "3f101077e9167d5a1047ea75b444eefdaf2d3e842a580e7b38deca15838aff1b1031a77e0636faf41a26cc98111434f5f251bafdeb56ccc2acd56e9cb35802f4"
}