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
fix grammar