Spec, or protobuffer file?

[pramsey]

It would be nice if the spec were more in the spec, maybe with some diagrams to explain what it means to clip and transform coordinates into image space. It would be nice if the valid draw commands were not hidden in the protobuffer file, and had a bit more explanation (only three, right? 1, 2, and 7?) I guess, I'd either expect the spec description to be more complete, or for it to not exist and for the protobuffer file to be the whole thing (which it almost is now).

[springmeyer]

Yes, will be working on this in the coming weeks. I'll be moving over tickets and documentation from early work at https://github.com/mapbox/mapnik-vector-tile where we've been experimenting in the context of mapnik. The goal will be to document things without using any mapnik-specific terminology going forward.

[flippmoke]

I am hoping that the version 2 pull request covers all of your concerns @pramsey , feel free to reopen issue if it does not!