some formatting and additional notes for clarity