update to use code blocks with comments