[NEXUS-6045] docs and make nullables clear