So, I'm quietly launching the revamped LearnBitcoin.com today. It's a soft launch and I'm looking for some real feedback.
The previous version was an old Drupal course platform that just wasn't cutting it, so I decided to start fresh.
This new site is all about "Bitcoin only. No nonsense. Just have fun with it."
The goal for this whole project? To be the link a Bitcoiner sends to their dad in a DM.
It's all open source and licensed CC-BY-SA. There’s a public GitHub repo, and you can edit directly from any page.
Here's what we've got so far:
A guided experience with six chapters that take you from square one to being a self-custodial network participant. We cover rabbit holes, Bitcoin units, the supply curve, halvings, key space, UTXOs, mining, and more. Plus, there are 428 glossary terms specific to Bitcoin and a manifesto laying it all out in one page.
What we're skipping:
No altcoins. No mention of "crypto" in any entry. No price forecasts. Nothing about NFA. No chart analysis. No affiliate links or referral codes. No exchange suggestions. No newsletter pitches. No tracking pixels. Seriously, no pop-ups.
I’d really appreciate feedback on a few things:
Technical accuracy. Pick a glossary term or rabbit hole that you know well and let me know if we got it right.
The journey. Does it make sense if you read it without prep?
Voice. Do you feel the manifesto and glossary writing resonates?
Mobile experience. Check it out on your phone and tell me what doesn’t work or is annoying.
You can send feedback to hello@learnbitcoin.com or hit up GitHub issues on the content repo (link in the footer). Pull requests are totally welcome.
Edit: Looks like the post I was replying to got deleted, but they were good questions so will let the answers stand...
Thank you for the very thoughtful and encouraging feedback alexmorgandev!
Journey chapters and rabbit holes auto-link glossary terms inline (via a rehype plugin exact-title matches get a dotted-orange underline → linked entry). Hand curated links will likely be more contextually accurate and can be added easily.
Exactly the differentiator we tried to build. The Sovereignty chapter (Chapter 6 of the journey) names specific software (Bitcoin Core, Start9, Umbrel, Nix Bitcoin), gives a recommended hardware build ($200, Pi 5 + 1TB SSD), specifies disk/RAM requirements, and walks through the actual flashing/booting/connecting steps. The framing is "pick what's useful, skip what isn't." Not a checklist, but with enough concrete to act on.
Direct link: https://www.learnbitcoin.com/journey/sovereignty
Two rabbit holes go deeper on what your node is actually verifying:
https://www.learnbitcoin.com/rabbit-hole/utxos why "balance" is a UI fiction and what your node tracks instead
https://www.learnbitcoin.com/rabbit-hole/mining the proof-of-work side of validation, with live difficulty + hashrate widgets
What we could definitely add is a more concrete step by step guides as rabbit holes for specific hardware/node combos.
Would love your eyes on the journey chapter specifically. If anything is hand-wavy or under-specified for what you'd want to act on, that's the highest-value feedback we could get on the journey right now.
Both, actually, but weighted toward community-editable. The repo has a CONTRIBUTING.md that welcomes typos, factual corrections, clarifications, new entries, and new rabbit holes. We will merge fast on small fixes; bigger contributions get an issue-first conversation about scope and angle.
There's a published "what we will not merge" list too (altcoins, price predictions, affiliates, edgelord politics) and a voice guide. Closer to a publication that takes PRs than to Wikipedia. The CC-BY-SA license also means anyone can fork it and run their own school on top, that's intentional. The orange-pilled internet should have more of this content, not less.
If you're up for it, the highest-leverage contributions right now are: factual corrections to glossary entries in your wheelhouse, and clarifications to journey prose that you find confusing on first read. CONTRIBUTING.md has the full guide.
Love the idea. Many of these websites are corrupted by all sorts of things because people start doing it to profit instead of educate, there are maybe only a few websites that I could even consider sending to someone. This is why we often recommend reading Mastering Bitcoin or books like that because it is focused on Bitcoin in a good way. I've checked a few random pages in the glossary and for me they look good.
Did you mean to keep entries in the glossary section about altcoin related concepts? This sounds like you didn't, but I am not sure so here is one example that I have found while trying to open random pages in the glossary. https://www.learnbitcoin.com/glossary/alt-season/
Maybe you could avoid words like nuke because they are not really familiar in many age groups depending on what profession people have, and people who know only some English might even be more confused by them. Stick to as basic and common words possible everywhere!
I see you posted three topics about your site.
[Pre-Launch] LearnBitcoin.com Beta Seeking Feedback & Collabs from BitcoinTalk.
New Resource: Learn Bitcoin Glossary.
And this topic.
You can do it but I recommend to keep updating your project in a single thread, it's more easily to follow up your project developments for community. In your side, you can keep it updated by changing the topic title.
Like you can edit the OP of a first thread from "[Pre-Launch] LearnBitcoin.com Beta Seeking Feedback & Collabs from BitcoinTalk." to "New Resource: Learn Bitcoin Glossary." then to "Relaunching LearnBitcoin.com. Bitcoin only. No Bullshit. Looking for feedback."
And in a newest post in that first thread, you can change the post title like above too.
Thank you for the feedback, very happy to have it.
I went ahead and made this change you suggested, had not occurred to me, I credited you in the commit coment...
https://github.com/treib-holdings/learnbitcoin-content/commit/b4427bbe48edaf16a338d9cb185a55d5026cc20b
Appreciate that hd49728
That an excellent point and I had not considered it. To be candid the site we launched in Feb fell flat, this is a full redesign and conceptually very different so I felt it warranted a new thread, in the future I'll post updates here!
It is quite solid, but I think you need to go deeper into the Bitcoin rabbit hole. For example, you should first explain what money actually is.To explain what money is properly, you should look at the Austrian School of Economics.
When you explain what money is, you also need to explain how money emerges.How and why did gold become money? Through a market process that can be called monetization.Then, for example, you explain what monetization is, what price discovery is, and so on.
Then, for example, you explain what fiat currency is, and how bankers, in alliance with politicians, imposed it on society.I have some educational texts that I originally wrote in my own language. I could provide them and translate them into English
Wow. What a read. I was just reading through and it kept me re-asking myself questions about bitcoin. This is actually very good. Thanks for relaunching it. For me, i have no bad reviews on it, but good once. The first page of the journey had me locked in. I guess i never knew much about bitcoin generally. It had me searching the web more to get more knowledge and still going back to read more. Good job. Thanks again for relaunching it.
Nice project, op!
I love seeing someone making an effort to educate more Bitcoiners in the world.
Why not add a quiz section so people could take a short quiz to test their knowledge after reaching each section? It would help them retain the knowledge in a fun and playful kind of way. Maybe those who pass each section with flying colors could have their names added to a wall of fame or something. That might motivate people more? I don't know, just throwing suggestions around!
Anyway, great job!
Quick update on the relaunch + what's shipped, what's coming
Thanks to everyone who weighed in on the launch thread. A few things actioned, a few on the roadmap.
Done:
Replaced "nuke" jargon per Dogedegen's accessibility note credit in commits. Glossary audit on the "alt-season" entry. After thinking about it, the call is to keep it but rewrite from inside the manifesto voice rather than remove. Bitcoin-only doesn't mean pretending altcoin cycles don't exist it means naming the pattern accurately: recurring late-cycle phase where altcoins outperform BTC briefly, then underperform catastrophically; most go to zero relative to BTC. That's the Bitcoin-only read, not a tacit endorsement. New rabbit hole shipped: The 2010 Value Overflow Incident. Visual postmortem of CVE-2010-5139, the 53-block reorg, the patch that landed in five hours. Got a decent run on r/Bitcoin this week if anyone wants to compare notes on what worked.
On the roadmap:
BitGoba's suggestion to consolidate threads agreed. Going forward this thread is the canonical "LearnBitcoin updates" thread; new content drops as replies here. Dedicated threads only when the content is meaty enough that the discussion deserves its own space (the next one will be). goldkingcoiner's quiz + wall-of-fame idea taking it seriously, real roadmap item. End-of-chapter retention checks with a public leaderboard fits the culture. Not committing a date but it's not a maybe.
Currently in draft: Rabbit hole on quantum-safe Bitcoin. Shor's vs Grover's, the 34% exposed-pubkey number from BIP-361, the migration plan, the open question about Satoshi's coins. Will start a separate thread for it once it's live the discussion deserves focus.
Feedback channel stays the GitHub issue tracker for anything tracked, but reply here for anything half-formed.
Thanks, if you find some other places that uses some kind of jargon try to remember this advice and change it on your own. If I were you I would not spend time looking through everything just for this, but whenever you are checking on individual pages for some reason keep this in mind too.
It is a good solution, that is why I mentioned that I was not sure about that and your intent. I would like to make a note here that altcoin cycles may be a thing of the past, and so far the current cycle has proven that the altcoin season is dead. Whether it is dead temporarily or permanently we don't know, but we have not seen this cycle what you have written. There was a small wave of small cap over performance but those do not count because it is easy to make a 100x return on something that has a market cap of $1 million or $10 million.
Please don't open another thread. There are many proper threads where you can talk about this already. Many users open new threads about this same topic whenever they see a news article on some website, and that is not good. I will give you some examples where you can talk about this.
This is my thread about Bitcoin threats and it mentions the quantum threat explicitly https://bitcointalk.org/index.php?topic=5559777.msg65831442#msg65831442.
Here is a BIP-361 thread https://bitcointalk.org/index.php?topic=5580322.0.
And this one too https://bitcointalk.org/index.php?topic=5550298.0.
But there are many more about this topic, so please discuss in existing topics about it.
Security hardening pass:
SecurityHeaders A+ Mozilla Observatory 115/100 (10/10) A+ Qualys SSL Labs A +
Our "no tracking, no cookies, no ads" claim is backed by the actual response headers, not just bio copy.
Verifiable. See: https://www.learnbitcoin.com/security
Update: mempool chapter just shipped. Rabbit hole #7.
Bitcoin wants you to cut in line. The mempool isn't a queue - every node has its own, transactions sort by fee rate (sat/vB), and the highest bid confirms first. Cheap transactions still mine, just slower. Transactions below the floor evict after two weeks, but the BTC stays in the sender's wallet so they can rebroadcast at a higher rate.
What the chapter covers:
* One-minute visual walkthrough (broadcast -> propagation -> fee-rate sorting -> mining -> eviction -> rebroadcast)
* Interactive fee-rate histogram
* RBF and CPFP for stuck transactions (BIP 125)
* The mempool-policy vs consensus distinction
* What the 2023 inscription floods actually did to the fee market
https://www.learnbitcoin.com/rabbit-hole/mempool
Also recently:
* Bitcoin Pizza Day entry now includes jercos's own account of the May 2010 trade, with his permission. Primary-source receipts from the actual pizza buyer. https://www.learnbitcoin.com/glossary/bitcoin-pizza-day
Feedback welcome here or via the "Edit this page on GitHub" link on every page.
Quick update: first animated entry just landed in the glossary.
Multisig. 35-second animation walks 2-of-3 end to end - setup (three different makers, threshold of two), normal spend (two signatures, broadcast), loss scenario (one key gone, two remain), theft scenario (thief halts at one signature), and the three closing pillars (Multisig / Threshold-of-keys / Vendor-diverse).
https://www.learnbitcoin.com/glossary/multisig
Sixth animated piece on the site, first one embedded in a glossary entry.
Feedback welcome.
Update: seed-backup chapter just shipped. Rabbit hole #8.
12 words is your wallet. Lose them and you lose your bitcoin. The chapter walks the threat-model-first menu - paper, metal, passphrase, Shamir, multisig; with lots of photos of real hardware and backups. The multisig section also embeds the 35-second animation we shipped yesterday (same MP4 reused from the glossary).
Three threats: theft, loss, coercion. Defending one usually weakens defense against the others. The chapter takes a menu-not-prescription stance and walks the tradeoffs at each tier.
https://www.learnbitcoin.com/rabbit-hole/seed-backup-strategies
Also recently:
* Mempool rabbit hole shipped earlier this week with full multi-platform launch.
* Multisig glossary entry got the first animated entry treatment yesterday with a 35-second 2-of-3 walkthrough.
* Bitcoin Pizza Day glossary entry updated to include jercos's own account, with his permission.
* 8 ETF glossary entries and 6 post-quantum entries currently staged as drafts; flipping when the editorial pass is done.
Feedback welcome here or via the "Edit this page on GitHub" link.
Update: quantum rabbit hole just shipped.
Two attacks, two scales. Shor's algorithm breaks ECDSA/Schnorr given a sufficiently powerful quantum computer, the existential piece. Grover's algorithm halves SHA-256's effective security but doesn't break it, the haircut. The chapter walks the distinction honestly and refuses both the "don't worry" and "panic now" framings.
25.3% of supply currently sits at addresses with the pubkey already on-chain (P2PK from the Patoshi era, reused P2PKH/P2WPKH, all P2TR). Migration plan exists in BIP-361 draft: two-phase soft fork sunsetting legacy signatures over five years.
https://www.learnbitcoin.com/rabbit-hole/is-bitcoin-quantum-safe
Also recently:
* Six post-quantum glossary entries: Post-Quantum Bitcoin (umbrella), Shor's Algorithm, Grover's Algorithm, CRQC, ML-DSA/Dilithium, SLH-DSA/SPHINCS+.
* Chainquery x LearnBitcoin co-published a quantum-exposure snapshot at https://chainquery.com/reports/quantum-exposure this is what the 25.3% figure tracks against.
Feedback welcome here or via the "Edit this page on GitHub" link.