add a bit more clarification in certain areas