made paging a bit clearer. Closes #48
cleaning up docs.
Tweaking requirements
Added section on updating.