Methodology
How materials are selected, how a card is written and checked, and how authors can edit, add links to or remove their case.
Selection
- Sources are public: company engineering blogs, conference talks, papers and podcasts. Every card links to its original.
- A material is taken when it helps solve an applied product problem and the solution transfers to other companies.
- The method must be disclosed. A measured result is welcome but not required; how the result was checked is always stated as an evidence level.
- Panel discussions, vendor marketing and announcements without a method are left out.
How a card is made
- The full original is kept as text (article text, paper, or a talk transcript edited into an article). Originals not in English are translated into English and proofread.
- A draft card is written with the help of a language model, following a fixed template: problem, solution in brief, tools and methods, a digest with how to apply it, results, limitations and pitfalls.
- Independent critic passes check the draft: a fact-check of every claim and number against the original, a practitioner check (can you apply the method from the card alone), and an editorial pass. Their fixes are applied, then a style pass edits for readability without changing facts, numbers or links.
- Automated checks validate the structure, the classification (topics, tasks, methods, tools, evidence) and the links before a card is published.
Cards summarise and analyse other people's work in our own words. Figures from the originals are not reproduced. The original authors and their company are credited on every card.
Evidence levels
Simulation Theory Case story Offline eval In production A/B-tested
A/B-tested: an online controlled experiment. In production: observed after launch without a controlled test. Offline eval: measured on held-out data. Case story: described without measurement. Simulation and theory: modelled, not observed.
For authors: edits, links and removal
If a card misstates the original, or you are an author and want a card changed or removed, see for authors. Requests from authors are honoured without argument.
Independence
effectsize.io has no ads, no affiliate links and no relationship with the companies whose work it covers.