documented entry-point of usage