updated examples and spec