add documentation to orphaned method for WEB-8859 +review WEBCR-250