add html boilerplate
[tools.git] / doc / js.md
blob:a/doc/js.md -> blob:b/doc/js.md
  [HTML5 Boilerplate homepage](http://html5boilerplate.com) | [Documentation
  table of contents](README.md)
   
  # The JavaScript
   
  Information about the default JavaScript included in the project.
   
  ## main.js
   
  This file can be used to contain or reference your site/app JavaScript code.
  For larger projects, you can make use of a JavaScript module loader, like
  [Require.js](http://requirejs.org/), to load any other scripts you need to
  run.
   
  ## plugins.js
   
  This file can be used to contain all your plugins, such as jQuery plugins and
  other 3rd party scripts.
   
  One approach is to put jQuery plugins inside of a `(function($){ ...
  })(jQuery);` closure to make sure they're in the jQuery namespace safety
  blanket. Read more about [jQuery plugin
  authoring](http://docs.jquery.com/Plugins/Authoring#Getting_Started)
   
  ## vendor
   
  This directory can be used to contain all 3rd party library code.
   
  Minified versions of the latest jQuery and Modernizr libraries are included by
  default. You may wish to create your own [custom Modernizr
  build](http://www.modernizr.com/download/).