Insufficient Blocks Documentation

The blocks documentation is very underwhelming when it comes to trying to figure out how to do block events, properties, etc.

Something along the lines of this would no doubt be better.