diff --git a/README.md b/README.md
index b8138ea..9b51a9a 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
-Snap.svg
+[Snap.svg](http://snapsvg.io)
 ======
 
-JavaScript library for SVG.
+A JavaScript library for modern SVG graphics.
 
 API Reference is in `dist/reference.html`
 
@@ -17,11 +17,12 @@ Snap.svg uses [Grunt](http://gruntjs.com/) to build
 
         npm install -g grunt-cli
 
+_*You might need to use `sudo npm`, depending on your configuration._
+
 * Install dependencies with npm
 
         npm install
 
-
 _*Snap.svg uses Grunt 0.4.0. You might want to [read](http://gruntjs.com/getting-started) more on their website if you haven’t upgraded since a lot has changed._
 
 * Type `grunt` in the command line to build the files.
diff --git a/src/svg.js b/src/svg.js
index 746a249..7ce9cc5 100644
--- a/src/svg.js
+++ b/src/svg.js
@@ -2071,10 +2071,6 @@ function arrayFirstValue(arr) {
         }
         return res;
     };
-    // SIERRA unfamiliar with the phrase _caring function,_ so the text for the _setter_ param isn't clear.
-    // SIERRA With the animation's start/end states defined, how is its _speed_ distinguished from its _duration_?
-    // SIERRA Text explaining the mina format should move to the section on the mina object interface. (Prior comment applies: object interfaces need to also be documented.)
-    // SIERRA unclear how to express a custom _easing_ (+)
     /*\
      * Snap.animate
      [ method ]
@@ -2096,6 +2092,14 @@ function arrayFirstValue(arr) {
      o     status (function) gets or sets the status of the animation,
      o     stop (function) stops the animation
      o }
+     | var rect = Snap().rect(0, 0, 10, 10);
+     | Snap.animate(0, 10, function (val) {
+     |     rect.attr({
+     |         x: val
+     |     });
+     | }, 1000);
+     | // in given context is equivalent to
+     | rect.animate({x: 10}, 1000);
     \*/
     Snap.animate = function (from, to, setter, ms, easing, callback) {
         if (typeof easing == "function" && !easing.length) {
@@ -2107,7 +2111,6 @@ function arrayFirstValue(arr) {
         callback && eve.once("mina.finish." + anim.id, callback);
         return anim;
     };
-    // SIERRA Element.stop(). Does it _stop_ or _pause_ the animations? If you run Element.animate() to restart the animation, does it commence from the beginning?
     /*\
      * Element.stop
      [ method ]