Clean up building script a little

index.js

@@ -5,13 +5,31 @@ var Metalsmith = require('metalsmith'),
     navigation = require('metalsmith-navigation'),
     bower = require('bower');
 
-// Install bower dependencies
+/**
+ * Installs bower dependencies that are needed for docs site.
+ *
+ * @param {Function} callback A function that will be called when the
+ * dependencies are installed.
+ */
+var installBowerDependencies = function(callback) {
     bower.commands.install([], {}, {})
         .on('error', function(error) {
             throw error;
         })
         .on('end', function() {
-        // Build the site
+            if (typeof callback === 'function') {
+                callback();
+            }
+        });
+}
+
+/**
+ * Builds static HTML pages of the docs site.
+ *
+ * @param {Function} callback A function that will be called when the
+ * pages are built.
+ */
+var buildPages = function(callback) {
     (new Metalsmith(__dirname))
         // This data will be available inside the templates
         .metadata({
@@ -52,5 +70,13 @@ bower.commands.install([], {}, {})
             if (err) {
                 throw err;
             }
+            if (typeof callback === 'function') {
+                callback();
+            }
         });
+}
+
+// Build the site
+installBowerDependencies(function() {
+    buildPages();
 });