provide a simplified and documented API