All things testing. Best practices, tools, and tips.
View All Tags
The best documentation is always up to date. The best way to keep docs up to date is to make them executable.
I've spent six months building Test2Doc—turning Playwright tests into documentation—and writing a tutorial that puts it into practice. Here are the patterns I discovered for writing tests that read like user guides.
As foretold in the prophecy billions of years ago at the dawn of time, I said I was working on a tutorial to help teach TDD with Playwright, RedwoodSDK, and how to generate documentation with Test2Doc for Docusaurus.
And I did. The tutorial is complete and covers all the basic CRUD operations, best practices around testing, refactoring, and deploying to Cloudflare.
Test Driven Development (TDD): you've heard of it, maybe tried it, possibly given up on it. The theory sounds great, but how do you actually do it on a real project? That's what my new tutorial tackles, using RedwoodSDK and Playwright to test and generate documentation using Test2Doc!
A common problem in automated tests is that selectors, the way in which you select an element on a page, can change over time as development implements new features or requirements.