document difference in performance between FlagService search API and Flag::isFlagged()

It's easy to think that FlagService::getFlagging[s]() is the right way to determine whether things are flagged, but this is slower than Flag::isFlagged() because the latter queries the DB directly rather than query for and load entities.

This should be documented.