[flang][docs] Document plugin limitations

This was extracted from the discussion on
https://reviews.llvm.org/D108283

.

Co-authored-by: Kiran Chandramohan <kiran.chandramohan@arm.com>

Differential Revision: https://reviews.llvm.org/D109871