updated docs, add examples