add comment markers noting which code blocks are recommended and which are not