31 files changed, 8 insertions, 147 deletions
diff --git a/scss/_alert.scss b/scss/_alert.scss
index b264dc5af..aaa2a1da5 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 d9e3e0a88..edd7147e5 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 15d7b6e19..d2302b829 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 0679b170b..d85c63767 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 b42486974..97d225103 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 8eb4cdd26..c5a7fdfcb 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 da86108d6..89e68a381 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 e1c5413be..0de67d9ec 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 64dd73683..0a1abad29 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 4ee6674e5..d3588d270 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 2e82f70b2..1a4139f19 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 9e12e163a..b71d5b03d 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 a0a44dacd..df8aa10eb 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 eea2e4883..97806afed 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 d6dff7738..599f33558 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 de93eef4d..d90902290 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 f4093f138..c92e2b1c2 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 79733597f..35f46feb7 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 3eb193a16..f034c77c8 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 c5ccc9336..813ac36ff 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 32735c8e5..965454f7f 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 98db07500..06036c206 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 1434cc0f4..a52b9d1e2 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 0439a1cf1..2bd8415d5 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 87c06c445..a93a63426 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 772b853c7..ac4dc743a 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 658248fc4..5f0698fb9 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 073ef4ecf..941579ec9 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 fb8b371be..2f5cdb4f9 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 bafd964b6..c69ecc93e 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 648c94c60..ecb0c544d 100644
--- a/scss/_utilities.scss
+++ b/scss/_utilities.scss
@@ -1,9 +1,4 @@
 //
-// Utility classes
-// --------------------------------------------------
-
-
-//
 // Floats
 //