add documentation of the global RA pattern

Merged Ralf Jung requested to merge ralf/doc into master

@lepigre I would be particularly interested in your feedback as someone who is very new to Iris.

Merge request reports