Author

Powerduck

4 min read

Mocking Conditional Requests: ETags and 304 Not Modified

Quick answer: A mock that always returns 200 with a full body never exercises the conditional-request path, so a client bug in If-None-Match or ETag handling stays hidden until production.

Read article
4 min read

Resetting Mock State Between Tests for Real Isolation

Quick answer: Stateful mock servers are shared infrastructure, and if one test leaves stubs, counters, or scenario state behind, the next test starts from an unknown condition and fails for

Read article
4 min read

Generating an API Changelog Automatically from Spec Diffs

Quick answer: A reliable API changelog is generated by diffing two versions of the OpenAPI spec and classifying each change as breaking, non-breaking, or a deprecation, rather than maintained by

Read article
4 min read

Keeping Docs in Sync: Regenerating on Every Spec Change

Quick answer: Documentation stays accurate only when regeneration is wired into the same pipeline that changes the spec, not when it depends on a person remembering to rebuild the docs

Read article