ES|QL Code examples in the source code documentation

[picandocodigo]

Currently reference documentation can be generated with YARD docs in ./doc by running rake yard. Add source code examples to this documentation.
The tests have several good examples which can be used for this task.