Ask HN: Why isnt there a public spec for Bitcoin core?

by nnn1234on 6/30/2020, 1:43 PMwith 10 comments

Easy rebuttals: +There is no public spec for linux -https://refspecs.linuxfoundation.org/lsb.shtml +If you want one go build one Better reason - there isnt demand for this I would like to understand what other reasons there could be

by ypcxon 6/30/2020, 7:16 PM

I'm thinking what would be the purpose or added value of a separate "public spec" document (which would require a significant maintenance effort) when you already have [1] a healthy Github (or Gitlab) project governance going on, [2] Bitcoin feature proposal process.

  [1] https://github.com/bitcoin/bitcoin/projects
  [2] https://github.com/bitcoin/bips
When you upgrade your Bitcoin node software, the act of the upgrading is you casting your Yes vote for the changes introduced in that version. The BIPs etc. can help you understand these, but if you want to be 100% diligent, the only fully authoritative source is the state of (the code sources in) the git repo as referenced by the commit hash in the Bitcoin software you are upgrading to.

by twox2on 6/30/2020, 5:36 PM

Not sure if it's still the case but if I recall correctly, the majority of the bitcoin maintainers are employed by one company... so not sure there's an incentive for them.

by coralreefon 6/30/2020, 6:27 PM

What is a public spec?

https://en.bitcoin.it/wiki/Protocol_documentation

by the_hoseron 6/30/2020, 4:51 PM

Writing documentation is boring, and requires the kind of rigor and focus that I haven't found to be common in the Bitcoin community.

by rotterdamdevon 6/30/2020, 10:19 PM

Ponzi schemes generally don't have open specs. Defeats the purpose.