more documentation, because this can be confusing.