doc: revisions to modules/recorder.py