Seeking concept ACKs for transaction terminology BIP
6 messages, 5 Apr to 10 May 2023. Started by Murch.
Murch, Andrew Poelstra, Antoine Poinsot, Vincenzo Palazzo, josibake, Keagan McClelland
Hey everyone,
Over the years, I have participated in a few conversations about various aspects of transactions. Often a chunk of the conversation is spent on establishing a shared vocabulary. There are many competing terms—e.g. I can think of at least three additional terms that refer to `scriptPubKey`.
I’ve drafted an informational BIP that proposes terminology for various components and aspects of transactions. As some established terms are already contradictory, the proposal does not aim for a perfectly consistent selection of terms, but rather just to establish a shared vocabulary to avoid confusion.
Draft: https://github.com/Xekyo/bips/pull/1
Please let me know whether you’d be interested in the creation of such a BIP.
Cheers, Murch
On Wed, Apr 05, 2023 at 02:54:15PM -0400, Murch via bitcoin-dev wrote:
Quoted text (18 lines)
> Hey everyone, > > Over the years, I have participated in a few conversations about various > aspects of transactions. Often a chunk of the conversation is spent on > establishing a shared vocabulary. There are many competing terms—e.g. I can > think of at least three additional terms that refer to `scriptPubKey`. > > I’ve drafted an informational BIP that proposes terminology for various > components and aspects of transactions. As some established terms are > already contradictory, the proposal does not aim for a perfectly consistent > selection of terms, but rather just to establish a shared vocabulary to > avoid confusion. > > Draft: https://github.com/Xekyo/bips/pull/1 > > Please let me know whether you’d be interested in the creation of such a > BIP. >
I would be interested in such a BIP existing.
I will leave to others the hard work of bikeshedding every single term.
Cheers
Hello Murch,
It makes sense to me too. Thanks!
Antoine
-------- Original Message -------- On Apr 5, 2023, 8:54 PM, Murch via bitcoin-dev wrote:
Quoted text (1 line)
> Hey everyone, Over the years, I have participated in a few conversations about various aspects of transactions. Often a chunk of the conversation is spent on establishing a shared vocabulary. There are many competing terms—e.g. I can think of at least three additional terms that refer to `scriptPubKey`. I’ve drafted an informational BIP that proposes terminology for various components and aspects of transactions. As some established terms are already contradictory, the proposal does not aim for a perfectly consistent selection of terms, but rather just to establish a shared vocabulary to avoid confusion. Draft: https://github.com/Xekyo/bips/pull/1 Please let me know whether you’d be interested in the creation of such a BIP. Cheers, Murch _______________________________________________ bitcoin-dev mailing list bitcoin-dev@lists•linuxfoundation•org https://lists.linuxfoundation.org/mailman/listinfo/bitcoin-dev
On Wed Apr 5, 2023 at 8:54 PM CEST, Murch via bitcoin-dev wrote:
Quoted text (17 lines)
> Hey everyone, > > Over the years, I have participated in a few conversations about various > aspects of transactions. Often a chunk of the conversation is spent on > establishing a shared vocabulary. There are many competing terms—e.g. I > can think of at least three additional terms that refer to `scriptPubKey`. > > I’ve drafted an informational BIP that proposes terminology for various > components and aspects of transactions. As some established terms are > already contradictory, the proposal does not aim for a perfectly > consistent selection of terms, but rather just to establish a shared > vocabulary to avoid confusion. > > Draft: https://github.com/Xekyo/bips/pull/1 > > Please let me know whether you’d be interested in the creation of such a > BIP.
Make a lot of sense to me, just recently I found that I was using a complete different word to refering to `scriptPubKey` that only me was using :)
So, concept ACK.
Thanks!
Vincent.
Big Concept ACK.
I've participated in several Bitcoin developer education programs over the past few years and have noticed that a consistent stumbling block for students is reconciling the different terms used in blogs, transcripts, mailing list posts, etc.
Having a reference document like this to include early in the curriculum(s) will help reduce cognitive load.
In particular, I'd like to highlight the importance of the "synonyms" field: since we can't retroactively re-write materials using different terms, having the synonyms will help map various resources to a shared terminology.
Thanks for working on this!
Cheers, Josie
Sent with Proton Mail secure email.
------- Original Message ------- On Wednesday, April 5th, 2023 at 8:54 PM, Murch via bitcoin-dev <bitcoin-dev@lists•linuxfoundation•org> wrote:
Quoted text (24 lines)
> Hey everyone, > > Over the years, I have participated in a few conversations about various > aspects of transactions. Often a chunk of the conversation is spent on > establishing a shared vocabulary. There are many competing terms—e.g. I > can think of at least three additional terms that refer to `scriptPubKey`. > > I’ve drafted an informational BIP that proposes terminology for various > components and aspects of transactions. As some established terms are > already contradictory, the proposal does not aim for a perfectly > consistent selection of terms, but rather just to establish a shared > vocabulary to avoid confusion. > > Draft: https://github.com/Xekyo/bips/pull/1 > > Please let me know whether you’d be interested in the creation of such a > BIP. > > Cheers, > Murch > _______________________________________________ > bitcoin-dev mailing list > bitcoin-dev@lists•linuxfoundation•org > https://lists.linuxfoundation.org/mailman/listinfo/bitcoin-dev
Concept ACK,
The only way we can hope to have productive discussion is to minimize the amount of effort spent in miscommunication especially that which arises from unclear terminology. Which exact words refer to which meanings is somewhat arbitrary, (look at math, particularly abstract math), but what matters is that there is precision in their use to whatever degree is possible. Having a document of shared terminology helps us communicate with one another and speeds up the process of coming to social consensus on issues.
Stay Inspired, Keags
On Wed, Apr 5, 2023 at 2:54 PM Murch via bitcoin-dev < bitcoin-dev@lists•linuxfoundation•org> wrote:
Quoted text (25 lines)
> Hey everyone, > > Over the years, I have participated in a few conversations about various > aspects of transactions. Often a chunk of the conversation is spent on > establishing a shared vocabulary. There are many competing terms—e.g. I > can think of at least three additional terms that refer to `scriptPubKey`. > > I’ve drafted an informational BIP that proposes terminology for various > components and aspects of transactions. As some established terms are > already contradictory, the proposal does not aim for a perfectly > consistent selection of terms, but rather just to establish a shared > vocabulary to avoid confusion. > > Draft: https://github.com/Xekyo/bips/pull/1 > > Please let me know whether you’d be interested in the creation of such a > BIP. > > Cheers, > Murch > _______________________________________________ > bitcoin-dev mailing list > bitcoin-dev@lists•linuxfoundation•org > https://lists.linuxfoundation.org/mailman/listinfo/bitcoin-dev >