add docs for field changes