← notes

Five years maintaining bitcoin.org

Jul 6, 2015

Five years maintaining bitcoin.org, from July 2015 to June 2020.

Including merged pull requests, which is the part that makes this maintainership rather than contribution. The work is the unglamorous surface of a site a lot of people arrive at first: the exchange listings added and removed as services launched and died, the wallet wizard, getting-started, redirections in _config, locale fixes across de and en, RTL CSS, and the whitepaper translation index.

The engineering problem underneath almost all of it is that the site exists in dozens of languages at once, so every English edit has a blast radius. Change one sentence and every existing translation of that sentence now describes something the site no longer says. Nothing marks them, so the default behaviour is serving a confidently wrong translation, which is worse than falling back to English. The site has to model translation staleness explicitly, tying a translated string to a version of its source and flagging rather than serving when the source moves.

Matching point of view across the wallet wizard’s questions is the same problem at smaller scale: each sentence is fine and the sequence reads as broken, which per-string review never catches. Changing a whitepaper language label from Bokmal to Norsk (Bokmål) is the endonym question, a language picker is read by people who read that language.

Also: removing an explicit bundler pin from Gemfile.lock, which breaks builds.