the core functionality together with working examples