added some usage examples to docs