[clang] Add clang/docs/FunctionEffectAnalysis.rst. (llvm#109855)

Follow-on from llvm#99656, which introduces 2nd pass caller/callee analysis
for function effects.

Wrote a new documentation page, derived directly from the RFC posted to
LLVM Discourse earlier this year.

---------

Co-authored-by: Doug Wyatt <[email protected]>
Co-authored-by: Sirraide <[email protected]>

Author: 3 people