made examples in docs clearer