expanded docs/examples