Document .graphql and .gql file loading with graphql.macro

Created by: petetnt

This PR follows up #3909 and #5076 by adding documentation for the .graphql loading features through babel-plugin-macros.

Signed-off-by: petetnt pete.a.nykanen@gmail.com