updated documentation for fields as per #101 and #161