doc: move and edit reflection section

The Reflection section will be more visible and therefore probably more useful in devdocs. It has been orphaned in Metaprogramming for a while now, and I often forget it is even there -- which is unfortunate because I believe I put it there in the first place :facepunch:.

Also some significant edits and minor expansions in a separate commit.