What's the best practice for documenting when a string function might raise a ValueError?

In your function's docstring, clearly state the conditions under which a ValueError might be raised. Include specific examples of invalid input that will trigger the error. This helps users understand how to use your function correctly and anticipate potential errors. For example: `def my_string_function(s): """Processes a string. Raises ValueError if the string contains non-alphanumeric characters.""" ...`