update documentation for optional combine