update docs and add explicit field work to related fields