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
the `i` actually makes it case insensitive, as per normal regular expression flags