moving this comment up to javadoc might remove my concern for upstream comments