Improve docs:

* Add index.html, auto-generated by a grunt task
* Note that smooth-scrolling to `<a name="foo">`
  doesn't work with $('a').smoothScroll(); must use
  $.smoothScroll() inside event handler instead.
* Add note about beforeScroll callback
* Clean up options object comments
Clean up defaults object comments