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

[Chris Apple via cfe-commits]

https://github.com/cjappl commented:

(partial review, will do another pass later today -- overall looks great so far)

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