update docstrings with regard to the try-hard-option