From the institute

Ideas in practice.

Writing on software craft, civic technology and building things that last.

Topics
Projects
The archive

All posts

Testing and TDD
·6 min read

Twenty Six More Tests, Four Fewer Behaviours

Removing the mocks grew the suite from 44 tests to 70 and quietly deleted four behaviours, every one of them a failure path. Test count is not coverage.

E
EkoHacks Team
Testing and TDD
·6 min read

The Best Coverage Number in the Room

Same commit, same spec, same test count. The mocked suite ran 5.6 times faster, covered 3.5 fewer points of real code, and posted the best branch coverage.

E
EkoHacks Team
Shipping and Operations
·7 min read

We Promised Not to Watch. Then We Needed to See.

Our privacy policy said no analytics, and it was true. Adding a page counter meant reopening that promise in public: what we chose, what we refused, one commit.

E
EkoHacks Team
Shipping and Operations
·6 min read

A Privacy Policy You Can Diff

Our legal pages are files in the same repository as the site. Each now lists every change to its text, with the date and the diff, drawn from git at build time.

E
EkoHacks Team
Shipping and Operations
·7 min read

What We Count, and What We Refuse to Know

Every system that holds anything about a visitor, in one table in the privacy policy. Writing it found a form that no longer existed and one that wrote twice.

E
EkoHacks Team
Shipping and Operations
·8 min read

The Small Things the Crawler Notices

Speed is the part of findability you can measure on a laptop. Fonts and images we shipped without looking, an error page we did not have, and the numbers after.

E
EkoHacks Team
Testing and TDD
·7 min read

Telling the Machine What the Page Is

Structured data on every post, and a test that runs after each build and fails it when a page lacks what a crawler needs. First run: forty nine problems.

E
EkoHacks Team
Shipping and Operations
·6 min read

What the Link Looks Like Before Anyone Clicks

A link to any page on our site showed up as a bare rectangle of text. The share image is part of the page, and the build now puts one on every route.

E
EkoHacks Team
Shipping and Operations
·7 min read

A Map Drawn by the Build

Thirty six of our pages had never been visited by Google because nothing said they existed. The sitemap is drawn from the build, and it found a draft.

E
EkoHacks Team