added more notes inside code blocks