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

[Chris Apple via cfe-commits]

https://github.com/cjappl approved this pull request.

Overall, very thorough. I would wait for more eyes but this LGTM

https://github.com/llvm/llvm-project/pull/109855