update docs for scatter to actually correspond to current behaviour