I agree this would be a good addition to the docs; if nothing else, it could provide a place to put even more detailed hints.