clean out comments that aren't all that helpful

31 files changed, 8 insertions, 147 deletions

diff --git a/scss/_alert.scss b/scss/_alert.scss
index b264dc5af2..aaa2a1da58 100644
--- a/scss/_alert.scss
+++ b/scss/_alert.scss
@@ -1,9 +1,4 @@
 //
-// Alerts
-// --------------------------------------------------
-
-
-//
 // Base styles
 //
 
diff --git a/scss/_animation.scss b/scss/_animation.scss
index d9e3e0a88c..edd7147e51 100644
--- a/scss/_animation.scss
+++ b/scss/_animation.scss
@@ -1,7 +1,3 @@
-//
-// Component animations
-// --------------------------------------------------
-
 .fade {
   opacity: 0;
   transition: opacity .15s linear;
diff --git a/scss/_breadcrumb.scss b/scss/_breadcrumb.scss
index 15d7b6e190..d2302b829c 100644
--- a/scss/_breadcrumb.scss
+++ b/scss/_breadcrumb.scss
@@ -1,8 +1,3 @@
-//
-// Breadcrumbs
-// --------------------------------------------------
-
-
 .breadcrumb {
   padding: $breadcrumb-padding-vertical $breadcrumb-padding-horizontal;
   margin-bottom: $spacer-y;
diff --git a/scss/_button-group.scss b/scss/_button-group.scss
index 0679b170b9..d85c637679 100644
--- a/scss/_button-group.scss
+++ b/scss/_button-group.scss
@@ -1,8 +1,3 @@
-//
-// Button groups
-// --------------------------------------------------
-
-
 // Make the div behave like a button
 .btn-group,
 .btn-group-vertical {
diff --git a/scss/_buttons.scss b/scss/_buttons.scss
index b424869740..97d2251035 100644
--- a/scss/_buttons.scss
+++ b/scss/_buttons.scss
@@ -1,9 +1,4 @@
 //
-// Buttons
-// --------------------------------------------------
-
-
-//
 // Base styles
 //
 
diff --git a/scss/_carousel.scss b/scss/_carousel.scss
index 8eb4cdd267..c5a7fdfcba 100644
--- a/scss/_carousel.scss
+++ b/scss/_carousel.scss
@@ -1,8 +1,3 @@
-//
-// Carousel
-// --------------------------------------------------
-
-
 // Wrapper for the slide container and indicators
 .carousel {
   position: relative;
diff --git a/scss/_close.scss b/scss/_close.scss
index da86108d6f..89e68a3817 100644
--- a/scss/_close.scss
+++ b/scss/_close.scss
@@ -1,8 +1,3 @@
-//
-// Close icons
-// --------------------------------------------------
-
-
 .close {
   float: right;
   font-size: ($font-size-base * 1.5);
diff --git a/scss/_code.scss b/scss/_code.scss
index e1c5413be6..0de67d9ecc 100644
--- a/scss/_code.scss
+++ b/scss/_code.scss
@@ -1,8 +1,3 @@
-//
-// Code (inline and block)
-// --------------------------------------------------
-
-
 // Inline and block code styles
 code,
 kbd,
diff --git a/scss/_custom-forms.scss b/scss/_custom-forms.scss
index 64dd736830..0a1abad296 100644
--- a/scss/_custom-forms.scss
+++ b/scss/_custom-forms.scss
@@ -1,8 +1,3 @@
-//
-// Custom forms
-// --------------------------------------------------
-
-
 // Embedded icons from Open Iconic.
 // Released under MIT and copyright 2014 Waybury.
 // http://useiconic.com/open
diff --git a/scss/_dropdown.scss b/scss/_dropdown.scss
index 4ee6674e53..d3588d2707 100644
--- a/scss/_dropdown.scss
+++ b/scss/_dropdown.scss
@@ -1,8 +1,3 @@
-//
-// Dropdown menus
-// --------------------------------------------------
-
-
 // The dropdown wrapper (div)
 .dropup,
 .dropdown {
diff --git a/scss/_forms.scss b/scss/_forms.scss
index 2e82f70b28..1a4139f196 100644
--- a/scss/_forms.scss
+++ b/scss/_forms.scss
@@ -1,9 +1,4 @@
 //
-// Forms
-// --------------------------------------------------
-
-
-//
 // Textual form controls
 //
 
diff --git a/scss/_grid.scss b/scss/_grid.scss
index 9e12e163a8..b71d5b03df 100644
--- a/scss/_grid.scss
+++ b/scss/_grid.scss
@@ -1,8 +1,3 @@
-//
-// Grid system
-// --------------------------------------------------
-
-
 // Container widths
 //
 // Set the container width, and override it for fixed navbars in media queries.
diff --git a/scss/_input-group.scss b/scss/_input-group.scss
index a0a44dacdf..df8aa10eb9 100644
--- a/scss/_input-group.scss
+++ b/scss/_input-group.scss
@@ -1,9 +1,4 @@
 //
-// Input groups
-// --------------------------------------------------
-
-
-//
 // Base styles
 //
 
diff --git a/scss/_jumbotron.scss b/scss/_jumbotron.scss
index eea2e4883f..97806afed3 100644
--- a/scss/_jumbotron.scss
+++ b/scss/_jumbotron.scss
@@ -1,8 +1,3 @@
-//
-// Jumbotron
-// --------------------------------------------------
-
-
 .jumbotron {
   padding: $jumbotron-padding ($jumbotron-padding / 2);
   margin-bottom: $jumbotron-padding;
diff --git a/scss/_labels.scss b/scss/_labels.scss
index d6dff7738e..599f335582 100644
--- a/scss/_labels.scss
+++ b/scss/_labels.scss
@@ -1,7 +1,7 @@
+// Base class
 //
-// Labels
-// --------------------------------------------------
-
+// Requires one of the contextual, color modifier classes for `color` and
+// `background-color`.
 
 .label {
   display: inline-block;
diff --git a/scss/_list-group.scss b/scss/_list-group.scss
index de93eef4d0..d909022900 100644
--- a/scss/_list-group.scss
+++ b/scss/_list-group.scss
@@ -1,8 +1,3 @@
-//
-// List groups
-// --------------------------------------------------
-
-
 // Base class
 //
 // Easily usable on <ul>, <ol>, or <div>.
diff --git a/scss/_media.scss b/scss/_media.scss
index f4093f1385..c92e2b1c29 100644
--- a/scss/_media.scss
+++ b/scss/_media.scss
@@ -1,7 +1,3 @@
-//
-// Media
-// --------------------------------------------------
-
 @if $enable-flex {
   .media {
     display: flex;
@@ -47,7 +43,7 @@
 
 .media-object {
   display: block;
-  
+
   // Fix collapse in webkit from max-width: 100% and display: table-cell.
   &.img-thumbnail {
     max-width: none;
diff --git a/scss/_mixins.scss b/scss/_mixins.scss
index 79733597ff..35f46feb73 100644
--- a/scss/_mixins.scss
+++ b/scss/_mixins.scss
@@ -1,6 +1,3 @@
-// Mixins
-// --------------------------------------------------
-
 // Toggles
 //
 // Used in conjunction with global variables to enable certain theme features.
diff --git a/scss/_modal.scss b/scss/_modal.scss
index 3eb193a162..f034c77c83 100644
--- a/scss/_modal.scss
+++ b/scss/_modal.scss
@@ -1,8 +1,3 @@
-//
-// Modals
-// --------------------------------------------------
-
-
 // .modal-open      - body class for killing the scroll
 // .modal           - container to scroll within
 // .modal-dialog    - positioning shell for the actual modal
diff --git a/scss/_nav.scss b/scss/_nav.scss
index c5ccc93362..813ac36ffe 100644
--- a/scss/_nav.scss
+++ b/scss/_nav.scss
@@ -1,6 +1,7 @@
+// Base class
 //
-// Navs
-// --------------------------------------------------
+// Kickstart any navigation component with a set of style resets. Works with
+// `<nav>`s or `<ul>`s.
 
 .nav {
   padding-left: 0;
diff --git a/scss/_navbar.scss b/scss/_navbar.scss
index 32735c8e58..965454f7f4 100644
--- a/scss/_navbar.scss
+++ b/scss/_navbar.scss
@@ -1,8 +1,3 @@
-//
-// Navbars
-// --------------------------------------------------
-
-
 // Wrapper and base class
 //
 // Provide a static navbar from which we expand to create full-width, fixed, and
diff --git a/scss/_pager.scss b/scss/_pager.scss
index 98db07500f..06036c206a 100644
--- a/scss/_pager.scss
+++ b/scss/_pager.scss
@@ -1,8 +1,3 @@
-//
-// Pager pagination
-// --------------------------------------------------
-
-
 .pager {
   padding-left: 0;
   margin-top: $spacer-y;
diff --git a/scss/_pagination.scss b/scss/_pagination.scss
index 1434cc0f49..a52b9d1e23 100644
--- a/scss/_pagination.scss
+++ b/scss/_pagination.scss
@@ -1,8 +1,3 @@
-//
-// Pagination (multiple pages)
-// --------------------------------------------------
-
-
 .pagination {
   display: inline-block;
   padding-left: 0;
diff --git a/scss/_popover.scss b/scss/_popover.scss
index 0439a1cf15..2bd8415d54 100644
--- a/scss/_popover.scss
+++ b/scss/_popover.scss
@@ -1,8 +1,3 @@
-//
-// Popovers
-// --------------------------------------------------
-
-
 .popover {
   position: absolute;
   top: 0;
diff --git a/scss/_progress.scss b/scss/_progress.scss
index 87c06c445d..a93a634267 100644
--- a/scss/_progress.scss
+++ b/scss/_progress.scss
@@ -1,9 +1,4 @@
 //
-// Progress bars
-// --------------------------------------------------
-
-
-//
 // Progress animations
 //
 
diff --git a/scss/_responsive-embed.scss b/scss/_responsive-embed.scss
index 772b853c79..ac4dc743a0 100644
--- a/scss/_responsive-embed.scss
+++ b/scss/_responsive-embed.scss
@@ -1,7 +1,3 @@
-//
-// Responsive embed
-// --------------------------------------------------
-
 // Credit: Nicolas Gallagher and SUIT CSS.
 
 .embed-responsive {
diff --git a/scss/_tables.scss b/scss/_tables.scss
index 658248fc43..5f0698fb9b 100644
--- a/scss/_tables.scss
+++ b/scss/_tables.scss
@@ -1,10 +1,5 @@
 //
-// Custom tables
-// --------------------------------------------------
-
-
-//
-// Basic tables
+// Basic Bootstrap table
 //
 
 .table {
diff --git a/scss/_tooltip.scss b/scss/_tooltip.scss
index 073ef4ecfa..941579ec97 100644
--- a/scss/_tooltip.scss
+++ b/scss/_tooltip.scss
@@ -1,8 +1,3 @@
-//
-// Tooltips
-// --------------------------------------------------
-
-
 // Base class
 .tooltip {
   position: absolute;
diff --git a/scss/_type.scss b/scss/_type.scss
index fb8b371be0..2f5cdb4f95 100644
--- a/scss/_type.scss
+++ b/scss/_type.scss
@@ -1,9 +1,4 @@
 //
-// Typography
-// --------------------------------------------------
-
-
-//
 // Headings
 //
 
diff --git a/scss/_utilities-responsive.scss b/scss/_utilities-responsive.scss
index bafd964b63..c69ecc93e3 100644
--- a/scss/_utilities-responsive.scss
+++ b/scss/_utilities-responsive.scss
@@ -1,9 +1,4 @@
 //
-// Responsive: Utility classes
-// --------------------------------------------------
-
-
-//
 // Mixins
 //
 
diff --git a/scss/_utilities.scss b/scss/_utilities.scss
index 648c94c60f..ecb0c544d7 100644
--- a/scss/_utilities.scss
+++ b/scss/_utilities.scss
@@ -1,9 +1,4 @@
 //
-// Utility classes
-// --------------------------------------------------
-
-
-//
 // Floats
 //