TODO: improve wording and remove fullstops at the end of items
[tweeper.git] / README
diff --git a/README b/README
index d2d200b..5f22618 100644 (file)
--- a/README
+++ b/README
@@ -1,10 +1,12 @@
-Tweeper is a web scraper which extracts the most recent public tweets of
-a given user from their home page on Twitter.com and formats them in RSS, so
-the information can be conveniently accessed and collected by a feed reader.
+Tweeper is a web scraper which can be used to conveniently follow the public
+activity of social network users without the need to log in or even be
+subscribed to the social network; tweeper converts the public information to
+RSS so that it can be accessed and collected by a feed reader.
 
-Since Jun 11th 2013 Twitter.com retired their API v1.0, so it's not possible
-to access a user timeline via RSS anymore, and it's also become mandatory to
-authenticate via OAuth to access this _public_ information in JSON format:
+Since Jun 11th 2013, when Twitter.com retired their API v1.0, it has not been
+possible anymore to access a user timeline via RSS, and it has also become
+mandatory to authenticate via OAuth to access this _public_ information in the
+JSON format:
 
   https://dev.twitter.com/discussions/16289
   https://dev.twitter.com/discussions/11564
@@ -43,11 +45,11 @@ as the first argument.
 
 Example of use on the command line:
 
-  $ php tweeper.php http://twitter.com/NSACareers
+  $ php tweeper.php https://twitter.com/NSACareers
 
 Example of use as a Liferea[2] filter:
 
-  $ liferea-add-feed  "|php .../path_to_tweeper/tweeper.php http://twitter.com/NSAcareers"
+  $ liferea-add-feed  "|php .../path_to_tweeper/tweeper.php https://twitter.com/NSAcareers"
 
 Example of use with identi.ca:
 
@@ -56,4 +58,4 @@ Example of use with identi.ca:
 [2] http://lzone.de/liferea/
 
 Tweeper is licensed under the GPLv3.
-Tweeper was written by Antonio Ospite http://ao2.it
+Tweeper was written by Antonio Ospite https://ao2.it