more project book commenting and explanations