Move the information on contributing from the bundled documentation to a new root file - CONTRIBUTING. This is both a more meaningful location (not part of code documentation) and allows us to take advantage of GitHub's latest UI changes that prompt people to read a repo's guidelines before reporting issues or opening pull requests.
Avoid the problem with links in a directory README on github.com. GitHub displays a directory's README when at the dir level, which results in incorrect URLs when links are using relative paths. This is causing some confusion for people who browse to the documentation on GitHub and try to browse the docs from the automatically displayed README.
This reverts commit dd420ef. The commit itself broken all the links in the documentation README when the README was viewed directly (as intended). This meant people coming to the documentation from the html5boilerplate.com site, or those generating HTML from the markdown docs, were not able to view the docs.
This approach uses a pseudo-element to force the element's content downwards without covering the background of the element. The overflow is hidden. For IE 6/7, fallback to the cruder `text-indent` method. Known advantages: * Works in IE6+ (although better in IE8+). * Replaces any content in IE8+, including inner HTML. * Nothing new for people to learn. Works just like all "traditional" IR techniques (unlike NIR, which needs you to add the image using a pseudo-element's `content` and relies margins for sprite positioning). * Doesn't draw a large out-of-element box in modern browsers. You can even mix in something like `font: 10px/1 a` to reduce ce the size of the "off-screen" box, if you really need to. * Doesn't have any potential SEO problems from `font-size:0`. * Doesn't care about any minimum font-size that a browser might have. * Doesn't have any potential failed-IR problems from inherited styles, like text being positioned within the element's visible box (i.e., if you use other properties like `text-stroke`). Known issues: * Doesn't work when images are off or fail to load (same as every other IR technique apart from NIR). * If the IR'ed element has bottom-padding, then either it needs to be removed or the height of the pseudo-element needs to be bumped up (e.g., set to 200%). * Doesn't avoid the `inline-block` bug in IE 6/7 due to the text-indent fallback for those browsers. * Doesn't work on input elements (but they shouldn't be the subject of IR anyway). * There is the potential for some final-result differences between IE 6/7 and modern browsers, but this is already the case with other IR techniques. Fix gh-1149
Benefits of disentangling normalize.css from the rest of the project's CSS: * Easier to track normalize.css version. * Easier to update normalize.css. * Easier to remove normalize.css if the user wants. * Clearer distinction between normalizing CSS and the additions that HTML5 Boilerplate provides. Drawback is the additional HTTP request incurred from the extra stylesheet referenced in the HTML. However, we already do something similar for the JS, and anyone serious about performance is going to employ a build process to concatenate and minify CSS/JS. Ref gh-1132 Ref gh-1140
Include all documentation related to the project and its code. This ensures that docs are available offline and that any future download will have docs that relevant for the version in use. This change involves a documentation rewrite to update, simplify, clarify, and consolidate it.