Publish the crypto piece as a method rather than a verdict - #116
Merged
Merged
Conversation
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>
7 of 8 tasks
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>
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
force-pushed
the
guide-bitcoin-not-crypto
branch
from
September 7, 2026 23:56
6aae8f1 to
bc1b0a1
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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
Notes for the reviewer
relatedentries added onowning-your-bitcoin,what-is-money,twenty-one-million,who-decides-the-rulesandhow-custody-fails, plus one inline link fromowning-your-bitcoin—relatedis one-way inrender.mjs, so a new guide starts with no inbound links unless they are added.Tests
Every guard passing. 3,937 internal links checked, 0 broken. All glossary anchors resolve.
npm run buildcompletes with every guard passing.github/workflows/build.ymlGenerated output
docs/is committed hereThe offline artifact
Assets and third-party code
Before requesting review
🤖 Generated with Claude Code