update recorder with comments and minor changes