includes updated usage examples