fix docs, add examples