complete API section and reword other pages