Auth function needs to be documented

[Shelagh-Lewins]

The documentation does not explain how to use the 'auth' feature. The example given in issue https://github.com/alethes/meteor-pages/issues/131 is invaluable but new users will read the docs and not search issues.

As far as I can tell, any app should use auth because it's the only way to control server-side data publication and allow client-side options such as changing sort direction.

It would also be useful to highlight things such as the importance of returning 'skip' in the options, and the fact that perPage still needs to be set even though 'limit' overrides it. Or if I have misunderstood this, then the documentation should make clear what is really the right way to use it.

The "return a cursor" form of auth doesn't seem to work, perhaps because it doesn't seem to pass 'skip' through. It would help users to do one of the following:

• explain how to use it if it does work really
• fix it
• remove it from the docs and only recommend the method showin in issue https://github.com/alethes/meteor-pages/issues/131