added docs & usage examples