📅 Original date posted:2013-10-22 📝 Original message:All that is good practice, ...

Jeff Garzik [ARCHIVE] /

npub1kf0…3f58

2023-06-07 15:07:46

in reply to nevent1q…4slu

📅 Original date posted:2013-10-22
📝 Original message:All that is good practice, but we should avoid adding burdensome
process that might discourage BIP writing.

Consider a distributed approach: if you feel a draft needs more
sections or better language, submit a pull request yourself and help
community-edit the document.

On Tue, Oct 22, 2013 at 3:34 AM, Martin Sustrik <sustrik at 250bpm.com> wrote:
> On 22/10/13 09:03, Gregory Maxwell wrote:
>> On Mon, Oct 21, 2013 at 11:59 PM, Jean-Paul Kogelman
>> <jeanpaulkogelman at me.com> wrote:
>>> Have you seen: https://en.bitcoin.it/wiki/Protocol_specification ?
>>
>> Take care, the information in the wiki is woefully incomplete.
>
> Imagine myself, with no prior knowledge of Bitcoin looking at the
> document. It starts with "Hashes". What hashes? No idea what's going on.
> Etc.
>
> Now compare that to a well written RFC. It starts with introduction,
> description of the problem, explains the conceptual model of the
> solution, then dives into the details. There's also Security
> Considerations part in every RFC that is pretty relevant for Bitcoin.
>
> As I said, I am willing to help with writing such document, it would be
> a nice way of learning the stuff, however, help from core devs, such as
> answering question that may arise in the process, or reviewing the
> document would be needed.
>
> Martin
>
>
> ------------------------------------------------------------------------------
> October Webinars: Code for Performance
> Free Intel webinars can help you accelerate application performance.
> Explore tips for MPI, OpenMP, advanced profiling, and more. Get the most from
> the latest Intel processors and coprocessors. See abstracts and register >
> http://pubads.g.doubleclick.net/gampad/clk?id=60135991&iu=/4140/ostg.clktrk
> _______________________________________________
> Bitcoin-development mailing list
> Bitcoin-development at lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/bitcoin-development

--
Jeff Garzik
Senior Software Engineer and open source evangelist
BitPay, Inc. https://bitpay.com/

Author Public Key

npub1kf0ppcjaguxekg24yx6smgxlu73qn0k8lm0t2wrqc0scpl7u3sgsmf3f58

Seen on

wss://relay.noswhere.com

Show more details

Published at

2023-06-07 15:07:46

Kind type

1 Short Text Note

Event JSON

{ "id": "dd9bf6c91809d651affb138605d9c89b7abdd931b5cdecef560b2e544efb88ef", "pubkey": "b25e10e25d470d9b215521b50da0dfe7a209bec7fedeb53860c3e180ffdc8c11", "created_at": 1686150466, "kind": 1, "tags": [ [ "e", "7825845c40e7246842c64e1640ea39dcb04d6d8f430fae7ba311b465db0e4d0f", "", "root" ], [ "e", "736e065d40cd9c41467f2878b6e0487d19b64e669c1bf8ed51a3426db0b86ade", "", "reply" ], [ "p", "a07382f2047b309ebb8303d291bbe36556308187afdeaea697a464e7d3a93c53" ] ], "content": "📅 Original date posted:2013-10-22\n📝 Original message:All that is good practice, but we should avoid adding burdensome\nprocess that might discourage BIP writing.\n\nConsider a distributed approach: if you feel a draft needs more\nsections or better language, submit a pull request yourself and help\ncommunity-edit the document.\n\nOn Tue, Oct 22, 2013 at 3:34 AM, Martin Sustrik \u003csustrik at 250bpm.com\u003e wrote:\n\u003e On 22/10/13 09:03, Gregory Maxwell wrote:\n\u003e\u003e On Mon, Oct 21, 2013 at 11:59 PM, Jean-Paul Kogelman\n\u003e\u003e \u003cjeanpaulkogelman at me.com\u003e wrote:\n\u003e\u003e\u003e Have you seen: https://en.bitcoin.it/wiki/Protocol_specification ?\n\u003e\u003e\n\u003e\u003e Take care, the information in the wiki is woefully incomplete.\n\u003e\n\u003e Imagine myself, with no prior knowledge of Bitcoin looking at the\n\u003e document. It starts with \"Hashes\". What hashes? No idea what's going on.\n\u003e Etc.\n\u003e\n\u003e Now compare that to a well written RFC. It starts with introduction,\n\u003e description of the problem, explains the conceptual model of the\n\u003e solution, then dives into the details. There's also Security\n\u003e Considerations part in every RFC that is pretty relevant for Bitcoin.\n\u003e\n\u003e As I said, I am willing to help with writing such document, it would be\n\u003e a nice way of learning the stuff, however, help from core devs, such as\n\u003e answering question that may arise in the process, or reviewing the\n\u003e document would be needed.\n\u003e\n\u003e Martin\n\u003e\n\u003e\n\u003e ------------------------------------------------------------------------------\n\u003e October Webinars: Code for Performance\n\u003e Free Intel webinars can help you accelerate application performance.\n\u003e Explore tips for MPI, OpenMP, advanced profiling, and more. Get the most from\n\u003e the latest Intel processors and coprocessors. See abstracts and register \u003e\n\u003e http://pubads.g.doubleclick.net/gampad/clk?id=60135991\u0026iu=/4140/ostg.clktrk\n\u003e _______________________________________________\n\u003e Bitcoin-development mailing list\n\u003e Bitcoin-development at lists.sourceforge.net\n\u003e https://lists.sourceforge.net/lists/listinfo/bitcoin-development\n\n\n\n-- \nJeff Garzik\nSenior Software Engineer and open source evangelist\nBitPay, Inc. https://bitpay.com/", "sig": "b738cb5436daf51ac903f6ff8fae486e206a6b7bedc930d6e0ae8cc1cc819c3f4a2868d53e0074c680e7936558acd65f02091b1b9d1cc931eda036e2842a0dd6" }