I think there is value in both approaches. I oftentimes read through tests to see how a project works and how to use it in code. Docs are great for API details and arguments, but seeing how things can actually be used together is much more valuable.

What if the test had something along the lines of:

```
var localToGlobalPoint = new Point(x, y); // displayObject.localToGlobal(point)
var expected = { x: expectedX, y: expectedY } // matrix.invert().transformPoint(point);
```