deprecate old fields
add docs