Please don't use this file. Use it for inspiration and take the parts that make sense for your website, but don't just copy the entire file without examining it closely.

For example, this file disables the webkit text size adjustment on the iPhone. Text size adjustment is what makes most websites readable on the iPhone without excessive zooming / scrolling. You should disable it only if you are making a mobile optimized version of your website and the automatic text size adjustment actually causes problems.

Incorrect:

  /*
   * 1. Corrects text resizing oddly in IE 6/7 when body `font-size` is set using    
   *    `em` units.    
   * 2. Prevents iOS text size adjust after orientation change, without disabling    
   *    user zoom.    
   */

  html {    
      font-size: 100%; /* 1 */    
      -webkit-text-size-adjust: 100%; /* 2 */    
      -ms-text-size-adjust: 100%; /* 2 */    
  }

Your statement would be true if it was setting -webkit-text-size-adjust:none, but 100% does as the comment says and only prevents resizing when changing orientations.

Did you test this? On my iPhone (iOS 5.1.1), the above css snippet disabled automatic text size adjustment.

If you have an iPhone, look at my test pages to see for yourself:

http://jabakobob.net/2012/08/hntest/test.html (without snippet)

http://jabakobob.net/2012/08/hntest/test2.html (with snippet)

For me, the first page renders with a much more legible text size.

> this file disables the webkit text size adjustment on the iPhone.

No it doesn't.

Yes it does. See above.

No- in fact I'm sure the readme used to say "don't use this as a black box", instead use it as a starting point.

I believe that all of the CSS in there is the default CSS in at least one browser. It really intends to only normalize between browsers.

Well the page says Improves usability with subtle improvements.

Good point. I think the only usability improvement is:

  button, html input[type="button"], input[type="reset"], input[type="submit"] {
    cursor: pointer;
  }
  button[disabled], input[disabled] {
    cursor: default;
  }