We already discussed about the usage of the features offset, limit and total (http://aerogear-dev.1069024.n5.nabble.com/aerogear-dev-Query-Paging-Brainstorm-td764.html and http://aerogear-dev.1069024.n5.nabble.com/aerogear-dev-Paging-Demo-td1173.html)
Would be nice to have a document with a clear definition of the usage, to match with client side (iOS, Android, JS) expectations