standardize top level file comments

twbs · Jun 29, 2012 · cd2d821 · cd2d821
1 parent 98ebd54
commit cd2d821
Show file tree

Hide file tree

Showing 38 changed files with 147 additions and 85 deletions.
diff --git 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
@@ -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
@@ -1,5 +1,7 @@
-// BREADCRUMBS
+//
-// -----------
+// Breadcrumbs
+// --------------------------------------------------
+
 
 .breadcrumb {
   padding: 7px 14px;

diff --git 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
@@ -1,5 +1,6 @@
-// BUTTON STYLES
+//
-// -------------
+// Buttons
+// --------------------------------------------------
 
 
 // Base styles

diff --git 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
@@ -1,5 +1,7 @@
-// CLOSE ICONS
+//
-// -----------
+// Close icons
+// --------------------------------------------------
+
 
 .close {
   float: right;

diff --git 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
@@ -1,5 +1,7 @@
-// COMPONENT ANIMATIONS
+//
-// --------------------
+// Component animations
+// --------------------------------------------------
+
 
 .fade {
   opacity: 0;

diff --git 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
@@ -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
@@ -1,3 +1,8 @@
+//
+// Grid system
+// --------------------------------------------------
+
+
 // Fixed (940px)
 #grid > .core(@gridColumnWidth, @gridGutterWidth);
 

diff --git 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
@@ -1,5 +1,7 @@
-// LABELS & BADGES
+//
-// ---------------
+// Labels and badges
+// --------------------------------------------------
+
 
 // Base classes
 .label,

diff --git 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
@@ -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
@@ -1,5 +1,7 @@
-// MODALS
+//
-// ------
+// Modals
+// --------------------------------------------------
+
 
 // Recalculate z-index where appropriate
 .modal-open {

diff --git 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
@@ -1,6 +1,6 @@
-// NAVIGATIONS
+//
-// -----------
+// Navs
-
+// --------------------------------------------------
 
 
 // BASE CLASS

diff --git 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
@@ -1,5 +1,7 @@
-// PAGINATION
+//
-// ----------
+// Pagination (multiple pages)
+// --------------------------------------------------
+
 
 .pagination {
   height: @baseLineHeight * 2;

diff --git 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
@@ -1,5 +1,6 @@
-// PROGRESS BARS
+//
-// -------------
+// Progress bars
+// --------------------------------------------------
 
 
 // ANIMATIONS

diff --git 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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -1,7 +1,6 @@
 //
-// Tables.less
+// Tables
-// Tables for, you guessed it, tabular data
+// --------------------------------------------------
-// ----------------------------------------
 
 
 // BASE TABLES

diff --git 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
@@ -1,5 +1,7 @@
-// TOOLTIP
+//
-// ------=
+// Tooltips
+// --------------------------------------------------
+
 
 .tooltip {
   position: absolute;

diff --git 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
@@ -1,5 +1,7 @@
-// UTILITY CLASSES
+//
-// ---------------
+// Utility classes
+// --------------------------------------------------
+
 
 // Quick floats
 .pull-right {

diff --git 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
 // --------------------------------------------------