updated field order and documentation