document the frontend main functions