more docs, including examples