some examples of this in use would be good, the documentation looks a bit sparse.