by schema robust to option types
correct docs for dshape changes