update explanation of how this._isShown gets set