Even better words

README.md

@@ -48,8 +48,12 @@ It also resolves sets/albums on Flickr, SoundCloud and Vimeo, so this will work:
     https://www.flickr.com/photos/pikesley/sets/72157648589429938/
     https://vimeo.com/album/3296736
     https://soundcloud.com/rawfunkmaharishi/sets/islington-academy-sessions
+
+####Notes about *_sources*:
 
-Note that Purdie does not care how many files are in *_sources*, nor if the services are all mixed up together in those files, it will dump out one file per service (although this will likely change in the future). Note also that you can  specify a source file on the command line with the `-f` flag.
+* Purdie does not care how many files are in *_sources*, nor if the services are all mixed up together in those files - it will simply dump out one file per service
+* If a URL appears multiple times in a resolved list, only the first appearance will be propagated to the output
+* You can specify a source file on the command line with the `-f` flag
 
 You also need a *.env* file with the relevant credentials in it:
 
@@ -107,8 +111,8 @@ There's no reason I couldn't support other services - I've already added [YouTub
 * sports a `::matcher` class method which returns a string which will pick a URL out of an input file, and
 * has a `#distill` method which takes a URL representing an item on the service and returns a hash of metadata, see e.g.
   * [Flickr](https://github.com/rawfunkmaharishi/purdie/blob/master/lib/purdie/services/flickr.rb#L27)
-  * [SoundCloud](https://github.com/rawfunkmaharishi/purdie/blob/master/lib/purdie/services/soundcloud.rb#L31)
-  * [Vimeo](https://github.com/rawfunkmaharishi/purdie/blob/master/lib/purdie/services/vimeo.rb#L28)
+  * [SoundCloud](https://github.com/rawfunkmaharishi/purdie/blob/master/lib/purdie/services/soundcloud.rb#L13)
+  * [Vimeo](https://github.com/rawfunkmaharishi/purdie/blob/master/lib/purdie/services/vimeo.rb#L15)
 * and optionally a `::resolve_set` class method which takes a set or album URL for the service and returns a list of URLs for individual items
 
 then this should all Just Work. There's definitely a blog post in this, because Ruby introspection and metaprogramming is just mind-bogglingly powerful (and dangerous).