[css-paint-api-1] "This is how the class should look" is confusing

[domenic]

Web developers don't generally understand Web IDL. And implementers aren't going to be implementing this callback interface. This is confusing to both groups.

I'd suggest replacing it with a JavaScript example for web developers, e.g.

class PaintClass {
  static get inputProperties() { return []; }
  paint(ctx, geom, inputProperties) { /* ... */ }
}