Add documentation on filter and populate usage

As mentioned in #72 I was going to send you the docs I wrote for the API I made with your module,
I've added them to the readme file. Let me know if you want anything changed
unclear how 'x' relates to insecure users

maybe change to be 'female,male' and then the comment will be "returns all female or male users"