Add documentation for highlight suggestions.

This documentation is for issue 3442.

I believe I sent this pull request before and it was merged but I can't find it anywhere.