Clarify documentation in response to #597