add faq

behackett · Jun 1, 2010 · 0654135 · 0654135
1 parent dbe308d
commit 0654135
Show file tree

Hide file tree

Showing 3 changed files with 60 additions and 26 deletions.
diff --git a/css/style.css b/css/style.css
@@ -49,40 +49,50 @@ div.intro p {
 #hd #right-brace {
     float: right;
 }
-div.button {
+#buttons {
+    padding-top: 3em;
+    padding-bottom: 2em;
+}
+.button {
     text-align: center;
-    padding-top: 1em;
     font-size: 200%;
     color: black;
+    margin-left: 1.3em;
+}
+#first-button {
+    margin-left: 0em;
 }
-div.button a.nav {
+.button a.nav {
     text-decoration: none;
     color: black;
     border: 2px solid black;
     padding: 0.5em;
+    margin: 0em;
     border-radius: 0.5em;
     -moz-border-radius: 0.5em;
     -webkit-border-radius: 0.5em;
-    margin: 0em;
 }
-div.button a.selected, div.button a:focus {
-    -webkit-box-shadow: 0.15em 0.15em 0 #000;
-    -moz-box-shadow: 0.15em 0.15em 0 #000;
+.button a.selected, .button a:focus {
     margin-left: -0.15em;
+    margin-right: 0.15em;
     margin-top: -0.15em;
-	outline: none;
-}
-div.button a.nav:hover {
+    outline: none;
     -webkit-box-shadow: 0.15em 0.15em 0 #000;
     -moz-box-shadow: 0.15em 0.15em 0 #000;
+}
+.button a.nav:hover {
     margin-left: -0.15em;
+    margin-right: 0.15em;
     margin-top: -0.15em;
+    -webkit-box-shadow: 0.15em 0.15em 0 #000;
+    -moz-box-shadow: 0.15em 0.15em 0 #000;
 }
-div.button a.nav:active {
-    -webkit-box-shadow: -0.1em -0.1em 0 #000;
-    -moz-box-shadow: -0.1em -0.1em 0 #000;
+.button a.nav:active {
     margin-left: 0.1em;
+    margin-right: -0.1em;
     margin-top: 0.1em;
+    -webkit-box-shadow: -0.1em -0.1em 0 #000;
+    -moz-box-shadow: -0.1em -0.1em 0 #000;
 }
 ul li {
     list-style-type: disc;
@@ -158,10 +168,6 @@ td.op {
 td.ex {
     width: 19em;
 }
-#buttons {
-    padding-top: 2em;
-    padding-bottom: 2em;
-}
 #ft {
     border-top: 3px solid black;
     margin-top: 2em;

diff --git a/index.html b/index.html
@@ -51,16 +51,19 @@ <h3>Efficient</h3>
             </ol>
           </div>
         </div>
-        <div class="yui-gb" id="buttons">
-          <div class="yui-u first button">
+        <div id="buttons">
+          <span class="button" id="first-button">
             <a class="nav spec" href="#/specification" rel="address:specification">specification</a>
-          </div>
-          <div class="yui-u button">
+          </span>
+          <span class="button">
             <a class="nav lib" href="#/implementation" rel="address:implementation">implementations</a>
-          </div>
-          <div class="yui-u button">
+          </span>
+          <span class="button">
+            <a class="nav faq" href="#/faq" rel="address:faq">FAQ</a>
+          </span>
+          <span class="button">
             <a class="nav" href="http://groups.google.com/group/bson">discussion</a>
-          </div>
+          </span>
         </div>
         <a class="nojs" name="/specification"></a>
         <h2 class="nojs">Specification</h2>
@@ -432,6 +435,28 @@ <h3>Projects Using BSON</h3>
               using BSON, please <a href="http://github.com/mdirolf/bsonspec.org">add them</a>.
             </p>
           </div>
+          <a class="nojs" name="/faq"></a>
+          <h2 class="nojs">FAQ</h2>
+          <div class="info" id="faq">
+            <h3>What is the point of BSON when it is no smaller than
+            JSON in many cases?</h3>
+            <p>BSON is designed to be efficient in space, but in many
+            cases is not much more efficient than JSON. In some cases
+            BSON uses even more space than JSON. The reason for this
+            is another of the BSON design goals: traversability. BSON
+            adds some "extra" information to documents, like length
+            prefixes, that make it easy and fast to traverse.</p>
+
+            <h3>Where can I get more help/infomation?</h3>
+            <p>The best place to ask questions about BSON is on
+            the <a href="http://groups.google.com/group/bson">BSON
+            mailing list</a>.</p>
+
+            <h3>How can I contribute or make fixes to this site?</h3>
+            <p>The best way to contribute to this site is to
+            fork <a href="http://github.com/mdirolf/bsonspec.org">the
+            project</a> and send us a pull request.</p>
+          </div>
         </div>
       </div>
       <div id="ft">

diff --git a/js/bsonspec.js b/js/bsonspec.js
@@ -1,11 +1,11 @@
 function show_home() {
-    jQuery("div.button a").removeClass("selected");
+    jQuery(".button a").removeClass("selected");
     jQuery(".info").hide("fast");
     jQuery(".intro").show("fast");
 }
 
 function show_section(section) {
-    jQuery("div.button a").removeClass("selected");
+    jQuery(".button a").removeClass("selected");
     jQuery(".intro").hide("fast");
     jQuery(".info").hide("fast");
     jQuery("#" + section).show("fast");
@@ -26,6 +26,9 @@ jQuery(function() {
                                      case "/implementation":
                                          show_section("lib");
                                          break;
+                                     case "/faq":
+                                         show_section("faq");
+                                         break;
                                      default:
                                          jQuery.address.value("/");
                                      }