add html boilerplate
[tools.git] / doc / faq.md
blob:a/doc/faq.md -> blob:b/doc/faq.md
--- a/doc/faq.md
+++ b/doc/faq.md
@@ -1,1 +1,78 @@
+[HTML5 Boilerplate homepage](http://html5boilerplate.com) | [Documentation
+table of contents](README.md)
 
+# Frequently asked questions
+
+### Why is the URL for jQuery without "http"?
+
+This is an intentional use of [protocol-relative
+URLs](http://paulirish.com/2010/the-protocol-relative-url/)
+
+**N.B.** Using a protocol-relative URL for files that exist on a CDN is
+problematic when you try to view your local files directly in the browser. The
+browser will attempt to fetch the file from your local file system. We
+recommend that you use a local server to test your pages (or Dropbox). This can
+be done using Python by running `python -m SimpleHTTPServer` from your local
+directory, using Ruby by installing and running
+[asdf](https://rubygems.org/gems/asdf), and by installing any one of XAMPP,
+MAMP, or WAMP.
+
+
+### Why don't you automatically load the latest version of jQuery from the Google CDN?
+
+1. The latest version of jQuery may not be compatible with the existing
+   plugins/code on the site. Version updating should be an intentional
+   decision.
+2. The latest version has a very short `max-age=3600` compares to the specific
+   version of `max-age=31536000`, which means you won't get the benefits of
+   long-term caching.
+
+
+### Why is the Google Analytics code at the bottom? Google recommends it be placed the `head`.
+
+The advantage to placing it in the `head` is that you will track a user's
+pageview even if they leave the page before it has been fully loaded. However,
+putting the code at the bottom keeps all the scripts together and reinforces
+that scripts at the bottom are the right move.
+
+
+### How can I integrate [Twitter Bootstrap](http://twitter.github.com/bootstrap/) with HTML5 Boilerplate?
+
+You can use [Initializr](http://initializr.com) to create a custom build that
+includes HTML5 Boilerplate with Twitter Bootstrap.
+
+Read more about how [HTML5 Boilerplate and Twitter Bootstrap complement each
+other](http://www.quora.com/Is-Bootstrap-a-complement-OR-an-alternative-to-HTML5-Boilerplate-or-viceversa/answer/Nicolas-Gallagher).
+
+
+### How do I prevent phone numbers looking twice as large and having a Skype highlight?
+
+If this is occurring, it is because a user has the Skype browser extension
+installed.
+
+Use the following CSS to prevent Skype from formatting the numbers on your
+page:
+
+```css
+span.skype_pnh_container {
+    display: none !important;
+}
+
+span.skype_pnh_print_container {
+    display: inline !important;
+}
+```
+
+
+### Do I need to upgrade my sites each time a new version of HTML5 Boilerplate is released?
+
+No. You don't normally replace the foundations of a house once it has been
+built. There is nothing stopping you from trying to work in the latest changes
+but you'll have to assess the costs/benefits of doing so.
+
+
+### Where can I get help for support questions?
+
+Please ask for help on
+[StackOverflow](http://stackoverflow.com/questions/tagged/html5boilerplate).
+