Updated the readme.

RobertoGonzalez · RobertoGonzalez · commit c001a7f2523f · 2014-09-26T16:02:16.000-03:00
diff --git a/README.md b/README.md
@@ -1,7 +1,8 @@
 ## Midnight
 
-Switches dynamically between multiple header designs, so it looks in line with the content below it.
+A jQuery plugin that switches between multiple header designs as you scroll, so you always have a header that looks great with the content below it.
 
+**[Check out the demo](http://aerolab.github.io/midnight.js/)** (watch the logo as you scroll).
 
 ## Quick start
 
@@ -114,3 +115,9 @@ $('nav').midnight({
   defaultClass: 'default'
 });
 ```
+
+## Known Issues
+
+On iOS <7 and older Android devices scrollTop isn't updated fluently, which creates a choppy effect. It can be fixed somewhat by wrapping the body in container and detecting touch events, but we're leaving that as an open issue. We'll probably disable the effect on older mobile devices due to bad performance.
+
+You shouldn't add any sort of padding, margin or offset (top/left/right/bottom) to the nav, since it causes issues with rendering.
diff --git a/index.html b/index.html
@@ -19,7 +19,7 @@
   <meta property="og:description" content="Midnight.js is a jQuery plugin that lets you sublty change your headers to make them match the content as you scroll." />
   <meta property="og:image" content="http://aerolab.github.io/midnight.js/assets/images/midnight-facebook.png" />
   <meta property="og:url" content="http://aerolab.github.io/midnight.js" />
-  <meta property="fb:app_id" content="" />
+  <meta property="fb:app_id" content="344819049029949" />
   
   <!-- Twitter Stuff -->
   <meta property="twitter:card" content="summary" />
@@ -67,8 +67,8 @@
 
 
   <div class="top-links" data-midnight="white">
-    <a class="button" href="https://aerolab.github.io/midnight.js/midnight.jquery.js">Download</a>
-    <a class="button button-github" href="https://aerolab.github.io/midnight.js">Fork on GitHub</a>
+    <a class="button" href="https://aerolab.github.io/midnight.js/midnight.jquery.js" download>Download</a>
+    <a class="button button-github" href="https://github.com/Aerolab/midnight.js" target="_blank">Fork on GitHub</a>
   </div>
 
 
@@ -224,8 +224,8 @@ <h2>Further customization</h2>
     
       <div class="container">
         <div class="buttons wow fadeIn">
-          <a class="button" href="https://aerolab.github.io/midnight.js/midnight.jquery.js">Download</a>
-          <a class="button" href="https://aerolab.github.io/midnight.js"><i class="icon-github"></i> Fork on GitHub</a>
+          <a class="button" href="https://aerolab.github.io/midnight.js/midnight.jquery.js" download>Download</a>
+          <a class="button" href="https://github.com/Aerolab/midnight.js" target="_blank"><i class="icon-github"></i> Fork on GitHub</a>
         </div>
       </div>
 
