improve explanation of output displays and link to API