standardize top level file comments

38 files changed, 147 insertions, 85 deletions

diff --git a/less/accordion.less b/less/accordion.less
index 31b8cdc33d..c13c7be260 100644
--- a/less/accordion.less
+++ b/less/accordion.less
@@ -1,5 +1,6 @@
-// ACCORDION
-// ---------
+//
+// Accordion
+// --------------------------------------------------
 
 
 // Parent container
diff --git a/less/alerts.less b/less/alerts.less
index f8b2a888ad..703c19d128 100644
--- a/less/alerts.less
+++ b/less/alerts.less
@@ -1,7 +1,11 @@
-// ALERT STYLES
-// ------------
+//
+// Alerts
+// --------------------------------------------------
+
+
+// Base styles
+// -------------------------
 
-// Base alert styles
 .alert {
   padding: 8px 35px 8px 14px;
   margin-bottom: @baseLineHeight;
@@ -20,8 +24,9 @@
   line-height: @baseLineHeight;
 }
 
+
 // Alternate styles
-// ----------------
+// -------------------------
 
 .alert-success {
   background-color: @successBackground;
@@ -40,8 +45,10 @@
   color: @infoText;
 }
 
+
 // Block alerts
-// ------------------------
+// -------------------------
+
 .alert-block {
   padding-top: 14px;
   padding-bottom: 14px;
diff --git a/less/breadcrumbs.less b/less/breadcrumbs.less
index 111f12279f..c8a3807de2 100644
--- a/less/breadcrumbs.less
+++ b/less/breadcrumbs.less
@@ -1,5 +1,7 @@
-// BREADCRUMBS
-// -----------
+//
+// Breadcrumbs
+// --------------------------------------------------
+
 
 .breadcrumb {
   padding: 7px 14px;
diff --git a/less/button-groups.less b/less/button-groups.less
index 8234a893c8..26cc2091af 100644
--- a/less/button-groups.less
+++ b/less/button-groups.less
@@ -1,5 +1,6 @@
-// BUTTON GROUPS
-// -------------
+//
+// Button groups
+// --------------------------------------------------
 
 
 // Make the div behave like a button
diff --git a/less/buttons.less b/less/buttons.less
index c44ff3e6fc..876d359265 100644
--- a/less/buttons.less
+++ b/less/buttons.less
@@ -1,5 +1,6 @@
-// BUTTON STYLES
-// -------------
+//
+// Buttons
+// --------------------------------------------------
 
 
 // Base styles
diff --git a/less/carousel.less b/less/carousel.less
index 8fbd303154..01675af729 100644
--- a/less/carousel.less
+++ b/less/carousel.less
@@ -1,5 +1,7 @@
-// CAROUSEL
-// --------
+//
+// Carousel
+// --------------------------------------------------
+
 
 .carousel {
   position: relative;
diff --git a/less/close.less b/less/close.less
index 31fe6fcb36..c71a508f3f 100644
--- a/less/close.less
+++ b/less/close.less
@@ -1,5 +1,7 @@
-// CLOSE ICONS
-// -----------
+//
+// Close icons
+// --------------------------------------------------
+
 
 .close {
   float: right;
diff --git a/less/code.less b/less/code.less
index 0cae749a05..a3602de115 100644
--- a/less/code.less
+++ b/less/code.less
@@ -1,6 +1,7 @@
-// Code.less
-// Code typography styles for the <code> and <pre> elements
-// --------------------------------------------------------
+//
+// Code (inline and blocK)
+// --------------------------------------------------
+
 
 // Inline and block code styles
 code,
diff --git a/less/component-animations.less b/less/component-animations.less
index 1e1e78b851..d614263a76 100644
--- a/less/component-animations.less
+++ b/less/component-animations.less
@@ -1,5 +1,7 @@
-// COMPONENT ANIMATIONS
-// --------------------
+//
+// Component animations
+// --------------------------------------------------
+
 
 .fade {
   opacity: 0;
diff --git a/less/dropdowns.less b/less/dropdowns.less
index f55edbae7c..e9e91b6a4b 100644
--- a/less/dropdowns.less
+++ b/less/dropdowns.less
@@ -1,5 +1,7 @@
-// DROPDOWN MENUS
-// --------------
+//
+// Dropdown menus
+// --------------------------------------------------
+
 
 // Use the .menu class on any <li> element within the topbar or ul.tabs and you'll get some superfancy dropdowns
 .dropup,
diff --git a/less/forms.less b/less/forms.less
index 911af1a25e..f97d6aeef4 100644
--- a/less/forms.less
+++ b/less/forms.less
@@ -1,6 +1,6 @@
-// Forms.less
-// Base styles for various input types, form layouts, and states
-// -------------------------------------------------------------
+//
+// Forms
+// --------------------------------------------------
 
 
 // GENERAL STYLES
diff --git a/less/grid.less b/less/grid.less
index e62a960932..b63005c684 100644
--- a/less/grid.less
+++ b/less/grid.less
@@ -1,3 +1,8 @@
+//
+// Grid system
+// --------------------------------------------------
+
+
 // Fixed (940px)
 #grid > .core(@gridColumnWidth, @gridGutterWidth);
 
diff --git a/less/hero-unit.less b/less/hero-unit.less
index 0ffe82962a..672b7d7c74 100644
--- a/less/hero-unit.less
+++ b/less/hero-unit.less
@@ -1,5 +1,7 @@
-// HERO UNIT
-// ---------
+//
+// Hero unit
+// --------------------------------------------------
+
 
 .hero-unit {
   padding: 60px;
diff --git a/less/labels-badges.less b/less/labels-badges.less
index 0fbd7bbc61..7537b188a5 100644
--- a/less/labels-badges.less
+++ b/less/labels-badges.less
@@ -1,5 +1,7 @@
-// LABELS & BADGES
-// ---------------
+//
+// Labels and badges
+// --------------------------------------------------
+
 
 // Base classes
 .label,
diff --git a/less/layouts.less b/less/layouts.less
index cc53627ff7..24a2062117 100644
--- a/less/layouts.less
+++ b/less/layouts.less
@@ -1,7 +1,6 @@
 //
 // Layouts
-// Fixed-width and fluid (with sidebar) layouts
-// --------------------------------------------
+// --------------------------------------------------
 
 
 // Container (centered, fixed-width layouts)
diff --git a/less/mixins.less b/less/mixins.less
index fd162a0491..733dfd08b4 100644
--- a/less/mixins.less
+++ b/less/mixins.less
@@ -1,6 +1,6 @@
-// Mixins.less
-// Snippets of reusable CSS to develop faster and keep code readable
-// -----------------------------------------------------------------
+//
+// Mixins
+// --------------------------------------------------
 
 
 // UTILITY MIXINS
diff --git a/less/modals.less b/less/modals.less
index 870ad0dfe6..32aab7acd4 100644
--- a/less/modals.less
+++ b/less/modals.less
@@ -1,5 +1,7 @@
-// MODALS
-// ------
+//
+// Modals
+// --------------------------------------------------
+
 
 // Recalculate z-index where appropriate
 .modal-open {
diff --git a/less/navbar.less b/less/navbar.less
index d99894509c..38edac2885 100644
--- a/less/navbar.less
+++ b/less/navbar.less
@@ -1,5 +1,6 @@
-// NAVBAR (FIXED AND STATIC)
-// -------------------------
+//
+// Navbars
+// --------------------------------------------------
 
 
 // COMMON STYLES
diff --git a/less/navs.less b/less/navs.less
index 66ce6fa3ae..33bdfe1d0f 100644
--- a/less/navs.less
+++ b/less/navs.less
@@ -1,6 +1,6 @@
-// NAVIGATIONS
-// -----------
-
+//
+// Navs
+// --------------------------------------------------
 
 
 // BASE CLASS
diff --git a/less/pager.less b/less/pager.less
index 4244b5eb80..e19d50aaa3 100644
--- a/less/pager.less
+++ b/less/pager.less
@@ -1,5 +1,7 @@
-// PAGER
-// -----
+//
+// Pager pagination
+// --------------------------------------------------
+
 
 .pager {
   margin-left: 0;
diff --git a/less/pagination.less b/less/pagination.less
index d978a7b8c0..9b0066077a 100644
--- a/less/pagination.less
+++ b/less/pagination.less
@@ -1,5 +1,7 @@
-// PAGINATION
-// ----------
+//
+// Pagination (multiple pages)
+// --------------------------------------------------
+
 
 .pagination {
   height: @baseLineHeight * 2;
diff --git a/less/popovers.less b/less/popovers.less
index ca69ca8018..5ea79cf73c 100644
--- a/less/popovers.less
+++ b/less/popovers.less
@@ -1,5 +1,7 @@
-// POPOVERS
-// --------
+//
+// Popovers
+// --------------------------------------------------
+
 
 .popover {
   position: absolute;
diff --git a/less/progress-bars.less b/less/progress-bars.less
index 3b47e64828..abcbe87611 100644
--- a/less/progress-bars.less
+++ b/less/progress-bars.less
@@ -1,5 +1,6 @@
-// PROGRESS BARS
-// -------------
+//
+// Progress bars
+// --------------------------------------------------
 
 
 // ANIMATIONS
diff --git a/less/reset.less b/less/reset.less
index 2332e03c30..1c408e3698 100644
--- a/less/reset.less
+++ b/less/reset.less
@@ -1,6 +1,8 @@
-// Reset.less
-// Adapted from Normalize.css http://github.com/necolas/normalize.css
-// ------------------------------------------------------------------------
+//
+// Modals
+// Adapted from http://github.com/necolas/normalize.css
+// --------------------------------------------------
+
 
 // Display in IE6-9 and FF3
 // -------------------------
diff --git a/less/responsive-1200px-min.less b/less/responsive-1200px-min.less
index f8ae95979b..4f35ba6ca2 100644
--- a/less/responsive-1200px-min.less
+++ b/less/responsive-1200px-min.less
@@ -1,5 +1,7 @@
-// LARGE DESKTOP & UP
-// ------------------
+//
+// Responsive: Large desktop and up
+// --------------------------------------------------
+
 
 @media (min-width: 1200px) {
 
diff --git a/less/responsive-767px-max.less b/less/responsive-767px-max.less
index 84d1ba13fc..105ac59845 100644
--- a/less/responsive-767px-max.less
+++ b/less/responsive-767px-max.less
@@ -1,6 +1,8 @@
-// LANDSCAPE PHONE TO SMALL DESKTOP & PORTRAIT TABLET
+//
+// Responsive: Landscape phone to desktop/tablet
 // --------------------------------------------------
 
+
 @media (max-width: 767px) {
 
   // Padding to set content in a bit
diff --git a/less/responsive-768px-979px.less b/less/responsive-768px-979px.less
index 3972ffc695..8e8c486a06 100644
--- a/less/responsive-768px-979px.less
+++ b/less/responsive-768px-979px.less
@@ -1,5 +1,7 @@
-// PORTRAIT TABLET TO DEFAULT DESKTOP
-// ----------------------------------
+//
+// Responsive: Tablet to desktop
+// --------------------------------------------------
+
 
 @media (min-width: 768px) and (max-width: 979px) {
 
diff --git a/less/responsive-navbar.less b/less/responsive-navbar.less
index 5a66a05592..7f01059ce5 100644
--- a/less/responsive-navbar.less
+++ b/less/responsive-navbar.less
@@ -1,3 +1,8 @@
+//
+// Responsive: Navbar
+// --------------------------------------------------
+
+
 // TABLETS AND BELOW
 // -----------------
 @media (max-width: 979px) {
diff --git a/less/responsive-utilities.less b/less/responsive-utilities.less
index 1962a2f152..59deafe81c 100644
--- a/less/responsive-utilities.less
+++ b/less/responsive-utilities.less
@@ -1,5 +1,7 @@
-// RESPONSIVE CLASSES
-// ------------------
+//
+// Responsive: Utility classes
+// --------------------------------------------------
+
 
 // Hide from screenreaders and browsers
 // Credit: HTML5 Boilerplate
diff --git a/less/scaffolding.less b/less/scaffolding.less
index 57c74eda07..5bc90cc168 100644
--- a/less/scaffolding.less
+++ b/less/scaffolding.less
@@ -1,6 +1,6 @@
+//
 // Scaffolding
-// Basic and global styles for generating a grid system, structural layout, and page templates
-// -------------------------------------------------------------------------------------------
+// --------------------------------------------------
 
 
 // Body reset
diff --git a/less/sprites.less b/less/sprites.less
index 753871cd77..fa0b31da03 100644
--- a/less/sprites.less
+++ b/less/sprites.less
@@ -1,6 +1,6 @@
-// SPRITES
-// Glyphs and icons for buttons, nav, and more
-// -------------------------------------------
+//
+// Sprites
+// --------------------------------------------------
 
 
 // ICONS
diff --git a/less/tables.less b/less/tables.less
index ecd92233db..d0ab2f3c5b 100644
--- a/less/tables.less
+++ b/less/tables.less
@@ -1,7 +1,6 @@
 //
-// Tables.less
-// Tables for, you guessed it, tabular data
-// ----------------------------------------
+// Tables
+// --------------------------------------------------
 
 
 // BASE TABLES
diff --git a/less/thumbnails.less b/less/thumbnails.less
index aa69f8e33d..d609c7df31 100644
--- a/less/thumbnails.less
+++ b/less/thumbnails.less
@@ -1,5 +1,8 @@
-// THUMBNAILS
-// ----------
+//
+// Thumbnails
+// --------------------------------------------------
+
+
 // Note: `.thumbnails` and `.thumbnails > li` are overriden in responsive files
 
 // Make wrapper ul behave like the grid
diff --git a/less/tooltip.less b/less/tooltip.less
index 5111a193f0..8593e2b5f3 100644
--- a/less/tooltip.less
+++ b/less/tooltip.less
@@ -1,5 +1,7 @@
-// TOOLTIP
-// ------=
+//
+// Tooltips
+// --------------------------------------------------
+
 
 .tooltip {
   position: absolute;
diff --git a/less/type.less b/less/type.less
index 41514b56c5..61a7db493a 100644
--- a/less/type.less
+++ b/less/type.less
@@ -1,6 +1,6 @@
-// Typography.less
-// Headings, body text, lists, code, and more for a versatile and durable typography system
-// ----------------------------------------------------------------------------------------
+//
+// Typography
+// --------------------------------------------------
 
 
 // BODY TEXT
diff --git a/less/utilities.less b/less/utilities.less
index d60d220311..35267b3053 100644
--- a/less/utilities.less
+++ b/less/utilities.less
@@ -1,5 +1,7 @@
-// UTILITY CLASSES
-// ---------------
+//
+// Utility classes
+// --------------------------------------------------
+
 
 // Quick floats
 .pull-right {
diff --git a/less/variables.less b/less/variables.less
index bd3a2905d0..09dc554942 100644
--- a/less/variables.less
+++ b/less/variables.less
@@ -1,10 +1,9 @@
-// Variables.less
-// Variables to customize the look and feel of Bootstrap
-// -----------------------------------------------------
-
+//
+// Variables
+// --------------------------------------------------
 
 
-// GLOBAL VALUES
+// Global values
 // --------------------------------------------------
 
 
diff --git a/less/wells.less b/less/wells.less
index bac3715a7d..e4e0a9bebe 100644
--- a/less/wells.less
+++ b/less/wells.less
@@ -1,6 +1,9 @@
-// WELLS
-// -----
+//
+// Wells
+// --------------------------------------------------
 
+
+// Base class
 .well {
   min-height: 20px;
   padding: 19px;