simplified api and examples