first few updates for records documentation