Reference docs fixes

I was reading through the new aggregations docs and found a few
minor quibbles that I ironed out in the process:

* Make it clearer that `aggs` is an allowed synomym
 for the `aggregations` key
* Fix broken example in for datehistogram, `1.5M` is
 not an allowed interval
* Make use of colon before examples consistent
* Fix typos