update readme with basic definitions and fields of interest