Remix.run Logo
boxed 2 hours ago

I wrote a bunch of custom tooling for iommi, I have a write up of it here: https://kodare.net/2025/08/08/documentation-that-is-never-wr...

lukicov an hour ago | parent [-]

The framing that the test suite is the documentation stuck with me: executing the examples removes the duplication rather than tracking it. Taking ideas from this, thank you!

boxed 3 minutes ago | parent [-]

We did it the other way around first, but it was a huge hassle and very hacky. Since we flipped it we've been much more satisfied with the system.

It's somewhat inspired by literate programming, but a bit flipped.