After thinking about this some more, I'm actually finding myself leaning towards leaving the hint and potentially adding more detail to the documentation as a follow-up patch.
Sounds good to me. I think my hesitation was more that the hint was overpromising help, so big +1 to more detail and keeping it.