code review README feedback
diff --git a/sparse_strips/vello_sparse_tests/README.md b/sparse_strips/vello_sparse_tests/README.md
index 36f2f88..d8903dd 100644
--- a/sparse_strips/vello_sparse_tests/README.md
+++ b/sparse_strips/vello_sparse_tests/README.md
@@ -9,14 +9,41 @@
</div>
-This is a development only crate for testing the sparse_strip renderers across a corpus of reference
+This is a development-only crate for testing the sparse_strip renderers across a corpus of reference
images:
- - cpu
- - wgpu
- - wasm32 WebGL
+- CPU
+- WGPU
+- WASM32 WebGL
+
+The `vello_test` proc macro will create a snapshot test for each supported renderer target. See the
+below example usage.
+
+```rs
+// Draws a filled triangle into a 125x125 scene.
+#[vello_test(width = 125, height = 125)]
+fn filled_triangle(ctx: &mut impl Renderer) {
+ let path = {
+ let mut path = BezPath::new();
+ path.move_to((5.0, 5.0));
+ path.line_to((95.0, 50.0));
+ path.line_to((5.0, 95.0));
+ path.close_path();
+
+ path
+ };
+
+ ctx.set_paint(LIME);
+ ctx.fill_path(&path);
+}
+```
+
+See all the attributes that can be passed to `vello_test` in `vello_dev_macros/test.rs`.
## Testing WebGL on the Browser
+Requirements:
+ - on MacOS, a minimum Clang major version of 20 is required.
+
To run the `vello_sparse_tests` suite on WebGL headless:
```sh
