I don't know that it is JavaDoc worthy. More helpful to the developer of the class and it's internals. It helps to explain the nuances of redirects as it relates to different domains. Something that the caller shouldn't need to be aware of from a 'doc' perspective.