Improve docs for `so`

Now they include a new user warning.