The brief
Ripcord is an open source library for retrying failed requests. It is used in eleven thousand services and had a README for a website.
The maintainers wanted a front door: somewhere to send people that explains the idea in the time it takes to decide.
What we made
- The install line and a three-line example above the fold, each with a copy button.
- Proof it is used, in live numbers: downloads, dependants, contributors.
- Docs in the same system, with a sidebar that follows the order people learn in.
Documentation is a product. It deserves a designer.
How it went
We read two years of issues before drawing anything, to find what people misunderstood first. The homepage answers those three things in order. The docs moved over in a week, written by the maintainers in Markdown.




