update notes on general record structure