Skip to content

Publish the crypto piece as a method rather than a verdict - #116

Merged
HodlDee merged 5 commits into
mainfrom
guide-bitcoin-not-crypto
Sep 8, 2026
Merged

HodlDee merged 5 commits into
mainfrom
guide-bitcoin-not-crypto

Conversation

@HodlDee

@HodlDee HodlDee commented Sep 7, 2026 •

Copy link
Copy Markdown
Owner

What this changes, and why

Publishes the draft in #87 — reframed. The draft asked reviewers to check every claim before publishing. Most held, one did not, and checking that one exposed a bigger problem than the claim itself.

New guide: Eight questions to ask about any digital asset (evaluating-a-monetary-asset, ~1,650 words, concepts, beginner).

Why the slug and framing changed

The homepage states the editorial standard: "Built to Inform, Not Persuade. Self-custody has no universal setup. We explain the options, the risks, and the tradeoffs that matter—so you can decide for yourself."

The draft as written did not meet it. It reached a conclusion on the reader's behalf, and the conclusion happened to be the one this site is built around — which makes it harder to notice, not easier. It would also have been the only guide in the library that argues a position rather than teaching something.

The strongest material in the draft was always the checklist: concentrated ownership, pre-mines, discretionary issuance, thin liquidity. That is a method. So the method now leads — eight structural questions, each with what a strong and a weak answer looks like — and bitcoin is the worked example rather than the thesis. Same evidence, same incidents, same limits; the reader draws the conclusion.

It is also more useful this way. A verdict about bitcoin helps with bitcoin. Eight questions help with the next thing marketed at someone, which will not be on any list written today.

Nothing was ever published under bitcoin-is-not-crypto, so there is no redirect to keep.

The claim that failed checking

The draft said bitcoin "has operated continuously" across national bans, exchange collapses and repeated drawdowns. Twice it has not.

August 2010 (CVE-2010-5139). Block 74638 carried a transaction creating roughly 184 billion bitcoin, because the check on outputs did not account for a sum that overflowed. A patched client shipped in about five hours; the honest chain overtook the bad one by block 74691. The cap held — but it held because people noticed, wrote a fix and ran it.

March 2013 (BIP 50). Moving from Berkeley DB to LevelDB dropped an accidental limit the old database imposed. A block split the network and it ran as two chains for roughly six hours until miners downgraded.

Both are retained, and in the reframed version they sit under the question they bear on — whether supply is enforced or promised — with the judgement about what they demonstrate handed to the reader rather than made for them.

Structure

  1. The eight questions (a three-column table: question / strong answer / weak answer)
  2. Bitcoin's answers, and how to check them
  3. What the weak answers look like together (the draft's pump-and-dump list, framed as risk factors rather than accusations)
  4. Twice, the answers needed people
  5. What the method does not tell you (nothing about price, volatility, safety, the businesses, or intent)
  6. Using it — including applying the questions to anything this site recommends

Notes for the reviewer

  • The register is the thing to disagree with. I think the reframe brings this inside the site's stated standard; if you think a verdict piece belonged in the library after all, this is the PR to say so on.
  • The draft's note asked to link Custody models explained #65 once both are published. That is Say that custody is a journey, without arguing anyone into buying #117, still open — the build guard rejects links to unpublished pages, so the cross-link is a follow-up once both merge.
  • One claim I softened without flagging separately: the draft said "keys are generated offline". They can be, and the protocol does not require it. The guide says what the protocol does and does not do instead.
  • Inbound related entries added on owning-your-bitcoin, what-is-money, twenty-one-million, who-decides-the-rules and how-custody-fails, plus one inline link from owning-your-bitcoin — related is one-way in render.mjs, so a new guide starts with no inbound links unless they are added.

Tests

npm run build

Every guard passing. 3,937 internal links checked, 0 broken. All glossary anchors resolve.

  • I ran the tests relevant to this change
  • npm run build completes with every guard passing
  • If I added a test, I wired it into .github/workflows/build.yml

Generated output

  • I changed build sources, and the regenerated docs/ is committed here

The offline artifact

  • The digest is unchanged

Assets and third-party code

  • This adds no images and no third-party code

Before requesting review

  • This contains no real seed phrase, private key, passphrase or entropy
  • This is not a security fix that should have gone through the private advisory form

🤖 Generated with Claude Code

Closes the draft in #87, which asked reviewers to check every claim before
publishing. Most held. One did not, and the fix made the piece stronger.

The draft said bitcoin "has operated continuously" across bans, collapses and
drawdowns. Twice it has not, and both occasions bear directly on the argument
rather than sitting beside it.

In August 2010 block 74638 carried a transaction creating roughly 184 billion
bitcoin, because the check on transaction outputs did not account for a sum
that overflowed. A patched client shipped in about five hours and the honest
chain overtook the bad one by block 74691. The supply cap held -- but it held
because people noticed, wrote a fix and ran it, which is a weaker and more
interesting claim than "the cap cannot fail". In March 2013 the move from
Berkeley DB to LevelDB dropped an accidental limit, a block split the network
in two, and it ran as two chains for around six hours until miners downgraded.

Both are now a section of their own rather than a footnote, because they are
the best available evidence for the section above them. Each failure was found,
published, fixed in the open, and resolved by independent operators choosing to
run corrected software, with no company to appeal to. That is what "no central
issuer" looks like under load. A page arguing that structure beats promises,
on a site whose whole instruction is verify rather than trust, cannot leave out
the two times the structure needed people.

Everything else follows the draft: the structural properties, the
pump-and-dump checklist as risk factors rather than accusations, the limits
stated as part of the argument, and the closing point that almost everything
which goes wrong in this industry goes wrong at the businesses.

Filed under concepts, since it explains why the setup looks as it does rather
than asking anyone to change theirs.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
The homepage states the editorial standard plainly: "Built to Inform, Not
Persuade. We explain the options, the risks, and the tradeoffs that matter --
so you can decide for yourself." The previous version of this guide did not
meet it. It reached a conclusion on the reader's behalf, and the conclusion
happened to be the one this site is built around, which makes it harder to
notice rather than easier.

The strongest part of the draft was always the checklist -- concentrated
ownership, pre-mines, discretionary issuance, thin liquidity. That is a method.
So the method now leads, as eight structural questions with what a strong and a
weak answer look like, and bitcoin is the worked example rather than the thesis.
Same evidence, same incidents, same limits; the reader draws the conclusion.

It is also more useful this way. A verdict about bitcoin helps with bitcoin.
Eight questions help with the next thing marketed at someone, which will not be
on any list written today.

Slug and title follow the reframing: evaluating-a-monetary-asset, "Eight
questions to ask about any digital asset". Nothing was published under the old
slug, so there is no redirect to keep.

The two failures stay, and now sit under the question they bear on -- whether
supply is enforced or promised -- with the judgement about what they demonstrate
handed to the reader rather than made for them.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@HodlDee HodlDee changed the title Publish the Bitcoin-is-not-crypto argument, with the two failures in it Publish the crypto piece as a method rather than a verdict Sep 7, 2026
From the external review. The guide said "Nobody lost coins" about the March
2013 chain split, which BIP 50 contradicts twice.

It records "at least one large double spend" during the fork -- experimental
rather than malicious, by someone testing whether it was possible -- and that
the pool operators who downgraded first to restore the older chain did so
"despite the fact that this caused them to sacrifice significant amounts of
money."

Neither of those is a customer left permanently out of pocket, and the
correction does not invent one. But a blanket no-loss claim erases both, on a
page whose whole argument is that claims should be checked rather than
repeated. Money moved that should not have, and mining revenue was thrown away
on purpose to end it.

BIP 50 is now cited at the paragraph as well as in the source note.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
HodlDee added a commit that referenced this pull request Sep 7, 2026
From the external review, and it is the finding I least enjoyed reading.

The opening called reading about custody for eight months and buying nothing
"the genuinely common failure", ranked "a person with coins on an exchange"
above "a person with a perfect mental model and no bitcoin", and pull-quoted
"having exposure is not the mistake."

That is persuasion about whether to own bitcoin, in the same batch where I
reframed #116 specifically because the homepage says "Built to Inform, Not
Persuade" and the draft reached a conclusion for the reader. Applying the
standard to one guide and breaking it in another is worse than not having
applied it at all.

Reducing shame about an existing exchange balance does not require shaming
someone who has chosen not to buy. The section now says plainly that whether to
own bitcoin at all is not a question this site answers, and that deciding it is
not for you, or not yet, is a complete answer.

What replaces the pressure is more useful than what it removes: **a first step
that involves buying nothing.** Set up a wallet with no money in it, generate a
backup, restore from it, send yourself a few thousand satoshis. It costs almost
nothing, every mistake is free, and it answers the question people are actually
stuck on -- whether they can do this at all -- without asking them to decide
anything about money first.

The heading changes from "Having some exposure beats waiting to be ready" to
"Wherever you are is a place to start from", and the summary drops "both are
better than eight months of research and no position." The rest of the guide is
unchanged: the rungs, the risk explanations, and the point that multisig is not
a mandatory destination were not what the finding was about.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
HodlDee added a commit that referenced this pull request Sep 7, 2026
Follow-up review of #116. "Nobody has documented customers left permanently out
of pocket" is a claim about all reporting everywhere, which this page has not
checked and cannot check.

It now says BIP 50 does not report that, which is what is actually known, and
BIP 50 is linked at the paragraph rather than only in the source note.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Follow-up review of #116. "Nobody has documented customers left permanently out
of pocket" is a claim about all reporting everywhere, which this page has not
checked and cannot check.

It now says BIP 50 does not report that, which is what is actually known, and
BIP 50 is linked at the paragraph rather than only in the source note.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@HodlDee
HodlDee force-pushed the guide-bitcoin-not-crypto branch from 6aae8f1 to bc1b0a1 Compare September 7, 2026 23:56
@HodlDee
HodlDee merged commit 5b33236 into main Sep 8, 2026
14 checks passed
@HodlDee
HodlDee deleted the guide-bitcoin-not-crypto branch September 8, 2026 05:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant