Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
//
//
-// Styleguide: Components.Atoms.MediaBlockBody
+// Style guide: Atoms.MediaBlockBody
//
.decanter-media-block__body {
- overflow: hidden;
+ @include overflow;
}
diff --git a/scss/components/atoms/_skipnav.scss b/scss/components/atoms/_skipnav.scss
index 6fc67c2a6..1f6ce6356 100644
--- a/scss/components/atoms/_skipnav.scss
+++ b/scss/components/atoms/_skipnav.scss
@@ -9,7 +9,7 @@
//
// Markup: ../../templates/components/atoms/skipnav/skipnav.html.twig
//
-// Styleguide: Components.Atoms.Skipnav
+// Style guide: Atoms.Skipnav
//
.decanter-skipnav {
@include skipnav;
diff --git a/scss/components/atoms/index.scss b/scss/components/atoms/index.scss
index 3808541cb..fc61e71f8 100644
--- a/scss/components/atoms/index.scss
+++ b/scss/components/atoms/index.scss
@@ -5,5 +5,6 @@
///
@import
+ 'buttons',
'media-block',
'skipnav';
diff --git a/scss/components/index.scss b/scss/components/index.scss
index d81242aea..468db8d3a 100644
--- a/scss/components/index.scss
+++ b/scss/components/index.scss
@@ -1,10 +1,5 @@
@charset "UTF-8";
-//
-// Components
-//
-// Style guide: Components
-
// Atoms
//
// Atoms are the basic building blocks of matter. Applied to web interfaces,
@@ -15,7 +10,9 @@
// their own. However, they’re good as a reference in the context of a pattern
// library as you can see all your global styles laid out at a glance.
//
-// Style guide: Components.Atoms
+// Weight: -1
+//
+// Style guide: Atoms
// Molecules
//
@@ -27,7 +24,9 @@
// but combine them together as a form and now they can actually do something
// together.
//
-// Style guide: Components.Molecules
+// Weight: -1
+//
+// Style guide: Molecules
// Organisims
//
@@ -48,9 +47,20 @@
// again. Building up from molecules to organisms encourages creating
// standalone, portable, reusable components.
//
-// Style guide: Components.Organisims
+// Weight: -1
+//
+// Style guide: Organisims
+
+//
+// Templates
+//
+// Weight: -1
+//
+// Style guide: Templates
+//
@import
'atoms/index',
'molecules/index',
- 'organisms/index';
+ 'organisms/index',
+ 'templates/index';
diff --git a/scss/components/molecules/_alerts.scss b/scss/components/molecules/_alerts.scss
index a39b882cb..886bf6ce8 100644
--- a/scss/components/molecules/_alerts.scss
+++ b/scss/components/molecules/_alerts.scss
@@ -14,7 +14,7 @@
//
// Markup: ../templates/components/molecules/alerts/alerts.html.twig
//
-// Style guide: Components.Molecules.Alerts
+// Style guide: Molecules.Alerts
//
.decanter-alert {
@include alerts;
diff --git a/scss/components/molecules/_icon-grid.scss b/scss/components/molecules/_icon-grid.scss
index 94a926f98..9ec645859 100644
--- a/scss/components/molecules/_icon-grid.scss
+++ b/scss/components/molecules/_icon-grid.scss
@@ -7,7 +7,7 @@
//
// Markup: ../../templates/components/molecules/icon-grid/icon-grid.html.twig
//
-// Style guide: Components.Molecules.IconGrid
+// Style guide: Molecules.IconGrid
//
.decanter-icon-grid {
@include icon-grid;
diff --git a/scss/components/molecules/_main-menu.scss b/scss/components/molecules/_main-menu.scss
index 449063eaf..04b9e26ae 100644
--- a/scss/components/molecules/_main-menu.scss
+++ b/scss/components/molecules/_main-menu.scss
@@ -7,7 +7,7 @@
//
// Markup: ../../../templates/components/molecules/main-menu/main-menu.html.twig
//
-// Styleguide: Components.Molecules.MainMenu
+// Style guide: Molecules.MainMenu
//
.decanter-main-menu {
@include main-menu;
diff --git a/scss/components/molecules/_mega-menu.scss b/scss/components/molecules/_mega-menu.scss
index 8073cb51d..5d28723f3 100644
--- a/scss/components/molecules/_mega-menu.scss
+++ b/scss/components/molecules/_mega-menu.scss
@@ -3,11 +3,13 @@
//
// Mega Menu
//
-// This is a mega menu.
+// An expandable menu in which choices are displayed in a two-dimensional
+// dropdown layout. Excellent design choice for accommodating a large number of
+// options or for revealing lower-level site pages at a glance.
//
// Markup:
Hello
//
-// Style guide: Components.Molecules.Mega Menu
+// Style guide: Molecules.Mega Menu
//
.decanter-megamenu {
@include megamenu;
diff --git a/scss/components/molecules/_sidenav.scss b/scss/components/molecules/_sidenav.scss
index db7466bd1..9b4695ebd 100644
--- a/scss/components/molecules/_sidenav.scss
+++ b/scss/components/molecules/_sidenav.scss
@@ -1,9 +1,14 @@
@charset "UTF-8";
//
-// SIDENAV COMPONENT
+// Sidenav
+//
+// A side navigation component.
+//
+// Markup: ../../templates/components/molecules/sidenav/sidenav.html.twig
+//
+// Style guide: Molecules.Sidenav
//
-
.decanter-sidenav__list {
@include sidenav-list;
}
diff --git a/scss/components/organisms/_accordions.scss b/scss/components/organisms/_accordions.scss
index aa77e36bb..da1c052ed 100644
--- a/scss/components/organisms/_accordions.scss
+++ b/scss/components/organisms/_accordions.scss
@@ -11,7 +11,7 @@
//
// Markup: ../../templates/components/organisms/accordions/accordions.html.twig
//
-// Styleguide: Components.Organisims.Accordion
+// Style guide: Organisims.Accordion
//
.decanter-accordion {
@include accordion-list;
diff --git a/scss/components/organisms/_hero-banner.scss b/scss/components/organisms/_hero-banner.scss
deleted file mode 100644
index 6d0e2b80f..000000000
--- a/scss/components/organisms/_hero-banner.scss
+++ /dev/null
@@ -1,9 +0,0 @@
-@charset "UTF-8";
-
-//
-// Hero
-//
-
-.decanter-hero-banner {
- @include hero-banner;
-}
diff --git a/scss/components/organisms/index.scss b/scss/components/organisms/index.scss
index 18c3a139c..e4a73e0c9 100644
--- a/scss/components/organisms/index.scss
+++ b/scss/components/organisms/index.scss
@@ -5,5 +5,4 @@
///
@import
- 'accordions',
- 'hero-banner';
+ 'accordions';
diff --git a/scss/components/templates/index.scss b/scss/components/templates/index.scss
index d535942d2..e6844deec 100644
--- a/scss/components/templates/index.scss
+++ b/scss/components/templates/index.scss
@@ -1,5 +1,8 @@
-//
-// Templates
-//
-// Style guide: Templates
-//
+@charset "UTF-8";
+
+///
+/// ROLL UP
+///
+
+// @import
+// 'template-file-name';
diff --git a/scss/core/index.scss b/scss/core/index.scss
index be49647bd..788faae7c 100644
--- a/scss/core/index.scss
+++ b/scss/core/index.scss
@@ -7,14 +7,20 @@
// Fonts
//
+// Markup: ../../templates/core/fonts/fonts.html.twig
+//
// Style guide: Core.Fonts
// Grid
//
+// Markup: ../../templates/core/grid/grid.html.twig
+//
// Style guide: Core.Grid
// Colors
//
+// Markup: ../templates/core/colors/colors.html.twig
+//
// Style guide: Core.Colors
@import
diff --git a/scss/elements/_embed.scss b/scss/elements/_embed.scss
index ee17799c1..840a7b97b 100644
--- a/scss/elements/_embed.scss
+++ b/scss/elements/_embed.scss
@@ -3,10 +3,13 @@
//
// Embed
//
-
// Responsive embed container to ensure that contents scale to the
// width of parent element while retaining an aspect ratio of 16:9.
-
+//
+// Markup: ../../templates/elements/embed/embed.html.twig
+//
+// Style guide: Elements.EmbedContainer
+//
.decanter-embed-container {
@include embed-container($aspect-height, $aspect-width);
}
diff --git a/scss/elements/_links.scss b/scss/elements/_links.scss
new file mode 100644
index 000000000..21edbab82
--- /dev/null
+++ b/scss/elements/_links.scss
@@ -0,0 +1,25 @@
+@charset "UTF-8";
+
+//
+// Links
+//
+// Default link styling, as well as special link treatment styling.
+//
+// .decanter-external-link - External Link
+// .decanter-more-link - More Link
+//
+// Markup: ../../templates/elements/links/links.html.twig
+//
+// Style guide: Elements.Links
+//
+a {
+ @include link;
+}
+
+.decanter-external-link {
+ @include external-link(external-link, external-link-hover);
+}
+
+.decanter-more-link {
+ @include more-link(more-link, more-link-hover);
+}
diff --git a/scss/elements/_list.scss b/scss/elements/_list.scss
index 5cb8bcea9..18e16f939 100644
--- a/scss/elements/_list.scss
+++ b/scss/elements/_list.scss
@@ -1,9 +1,14 @@
@charset "UTF-8";
//
-// List
+// Lists
+//
+// Default styling for lists, including ordered and unordered lists.
+//
+// Markup: ../../templates/elements/lists/lists.html.twig
+//
+// Style guide: Elements.Lists
//
-
ul,
ol {
@include margin(1em null);
diff --git a/scss/elements/_table.scss b/scss/elements/_table.scss
index c2b02af58..da41fccac 100644
--- a/scss/elements/_table.scss
+++ b/scss/elements/_table.scss
@@ -1,9 +1,18 @@
@charset "UTF-8";
//
-// Table
+// Tables
+//
+// Default styling for tables. For displaying tabular data that best lends
+// itself to being layed out in columns and rows.
+// Modifier class available to remove tables borders.
+//
+// .decanter-table--borderless - Borderless Table
+//
+// Markup: ../../templates/elements/tables/tables.html.twig
+//
+// Style guide: Elements.Tables
//
-
table {
@include tables;
}
diff --git a/scss/elements/_typography.scss b/scss/elements/_typography.scss
index b8268e003..f954b2ea1 100644
--- a/scss/elements/_typography.scss
+++ b/scss/elements/_typography.scss
@@ -3,7 +3,20 @@
//
// Typography
//
-
+// Default typography styling for base HTML typography elements, including
+// paragraphs and headings. Also includes special type treatment classes such as
+// splash font and lead font.
+//
+// .decanter-font-lead - Lead Font
+// .decanter-font-splash - Splash Font
+// .decanter-short-line-length - Short Line Length
+// .decanter-caption - Caption Font
+// .decanter-credits - Credits Font
+//
+// Markup: ../../templates/elements/font-styles/font-styles.html.twig
+//
+// Style guide: Elements.Typography
+//
html {
font-family: $font-sans;
font-size: $em-base;
@@ -20,18 +33,6 @@ p {
@include margin(1em null);
}
-a {
- @include link;
-}
-
-.decanter-external-link {
- @include external-link(external-link, external-link-hover);
-}
-
-.decanter-more-link {
- @include more-link(more-link, more-link-hover);
-}
-
h1,
h2,
h3,
diff --git a/scss/elements/helpers/_sr-only.scss b/scss/elements/helpers/_sr-only.scss
index cff2d2aa0..b7963a757 100644
--- a/scss/elements/helpers/_sr-only.scss
+++ b/scss/elements/helpers/_sr-only.scss
@@ -1,11 +1,15 @@
@charset "UTF-8";
+@charset "UTF-8";
+
//
-// Screen Reader Only
+// @sr-only
+//
+// Hides piece of content from the screen but keeps in the DOM for screen
+// readers.
+//
+// Style guide: Elements.Helpers.sr-only
//
-
-// Screen reader only helper.
-
.decanter-sr-only {
@include sr-only;
}
diff --git a/scss/elements/helpers/index.scss b/scss/elements/helpers/index.scss
index 49d4e98d3..fc58d33bd 100644
--- a/scss/elements/helpers/index.scss
+++ b/scss/elements/helpers/index.scss
@@ -1,8 +1,12 @@
@charset "UTF-8";
-///
-/// ROLL UP
-///
+//
+// Helpers
+//
+// Helper partials for element css.
+//
+// Style guide: Elements.Helpers
+//
@import
'sr-only';
diff --git a/scss/elements/index.scss b/scss/elements/index.scss
index c8053ef23..11e37c4bc 100644
--- a/scss/elements/index.scss
+++ b/scss/elements/index.scss
@@ -3,13 +3,15 @@
//
// Elements
//
-// Style guide: Core.Elements
+// Elements are individual units of an HTML document or web page.
+//
+// Style guide: Elements
@import
'helpers/index',
- 'buttons',
'embed',
'inputs',
+ 'links',
'list',
'table',
'typography';
diff --git a/scss/utilities/index.scss b/scss/utilities/index.scss
index 25e08bebb..9ac9b603b 100644
--- a/scss/utilities/index.scss
+++ b/scss/utilities/index.scss
@@ -3,11 +3,19 @@
//
// Functions
//
+// Programmatic procedure or routine to help making writing code or declaring
+// something easier and more seamlesss.
+//
// Style guide: Functions
//
// Mixins
//
+// Mixins help with things that are a bit tedious to write in CSS (e.g.,
+// vendor prefixes that exist). Mixins allow for making groups of CSS
+// declarations for reuse throughout a project. Mixins can even pass in values
+// to make things more flexible.
+//
// Style guide: Mixins
@import
diff --git a/scss/utilities/mixins/accessibility/_accessibly-hidden.scss b/scss/utilities/mixins/accessibility/_accessibly-hidden.scss
index c15e8773b..b6c6355ee 100644
--- a/scss/utilities/mixins/accessibility/_accessibly-hidden.scss
+++ b/scss/utilities/mixins/accessibility/_accessibly-hidden.scss
@@ -5,7 +5,7 @@
//
// Aria hidden helper.
//
-// Styleguide: Mixins.Accessibility.hidden
+// Style guide: Mixins.Accessibility.hidden
//
@mixin accessibly-hidden {
&[aria-hidden=true] {
diff --git a/scss/utilities/mixins/accessibility/_skipnav.scss b/scss/utilities/mixins/accessibility/_skipnav.scss
index cff2264ec..d07082a59 100644
--- a/scss/utilities/mixins/accessibility/_skipnav.scss
+++ b/scss/utilities/mixins/accessibility/_skipnav.scss
@@ -5,7 +5,7 @@
//
// Skip to navigation helper.
//
-// Styleguide: Mixins.Accessibility.skipnav
+// Style guide: Mixins.Accessibility.skipnav
//
@mixin skipnav {
background: transparent;
diff --git a/scss/utilities/mixins/accessibility/_sr-only.scss b/scss/utilities/mixins/accessibility/_sr-only.scss
index e23c7cce7..dde72033d 100644
--- a/scss/utilities/mixins/accessibility/_sr-only.scss
+++ b/scss/utilities/mixins/accessibility/_sr-only.scss
@@ -5,7 +5,7 @@
//
// Screen reader only content hiding helper.
//
-// Styleguide: Mixins.Accessibility.sr-only
+// Style guide: Mixins.Accessibility.sr-only
//
@mixin sr-only {
position: absolute;
diff --git a/scss/utilities/mixins/accessibility/index.scss b/scss/utilities/mixins/accessibility/index.scss
index c48d6c7aa..a88d8b1bc 100644
--- a/scss/utilities/mixins/accessibility/index.scss
+++ b/scss/utilities/mixins/accessibility/index.scss
@@ -3,7 +3,9 @@
//
// Accessibility
//
-// Styleguide: Mixins.Accessibility
+// Mixins for Accessibility
+//
+// Style guide: Mixins.Accessibility
//
@import
diff --git a/scss/utilities/mixins/accordions/_accordion-bordered.scss b/scss/utilities/mixins/accordions/_accordion-bordered.scss
index e1a5deef5..baf43cf2c 100644
--- a/scss/utilities/mixins/accordions/_accordion-bordered.scss
+++ b/scss/utilities/mixins/accordions/_accordion-bordered.scss
@@ -3,7 +3,9 @@
//
// @accordion-bordered
//
-// Styleguide: Mixins.Accordions.accordion-bordered
+// Adds a border to the accordion.
+//
+// Style guide: Mixins.Accordions.accordion-bordered
//
@mixin accordion-bordered {
.decanter-accordion__content {
diff --git a/scss/utilities/mixins/accordions/_accordion-button-unopened.scss b/scss/utilities/mixins/accordions/_accordion-button-unopened.scss
index 1d602a7c5..116928255 100644
--- a/scss/utilities/mixins/accordions/_accordion-button-unopened.scss
+++ b/scss/utilities/mixins/accordions/_accordion-button-unopened.scss
@@ -3,7 +3,9 @@
//
// @accordion-button-unopened
//
-// Styleguide: Mixins.Accordions.accordion-button-unopened
+// Adds the closed icon (plus) to the accordion.
+//
+// Style guide: Mixins.Accordions.accordion-button-unopened
//
@mixin accordion-button-unopened {
background-image: url("#{$image-path}/plus.png");
diff --git a/scss/utilities/mixins/accordions/_accordion-button.scss b/scss/utilities/mixins/accordions/_accordion-button.scss
index 2f8a89978..b196094b3 100644
--- a/scss/utilities/mixins/accordions/_accordion-button.scss
+++ b/scss/utilities/mixins/accordions/_accordion-button.scss
@@ -3,7 +3,9 @@
//
// @accordion-button
//
-// Styleguide: Mixins.Accordions.accordion-button
+// Default styling for the clickable button of an accordion.
+//
+// Style guide: Mixins.Accordions.accordion-button
//
@mixin accordion-button {
@include button-unstyled;
diff --git a/scss/utilities/mixins/accordions/_accordion-content.scss b/scss/utilities/mixins/accordions/_accordion-content.scss
index ff083956f..d444e3d0d 100644
--- a/scss/utilities/mixins/accordions/_accordion-content.scss
+++ b/scss/utilities/mixins/accordions/_accordion-content.scss
@@ -3,7 +3,9 @@
//
// @accordion-content
//
-// Styleguide: Mixins.Accordions.accordion-content
+// Default styling for the content within the expanded accordion.
+//
+// Style guide: Mixins.Accordions.accordion-content
//
@mixin accordion-content {
background-color: $color-white;
diff --git a/scss/utilities/mixins/accordions/_accordion-list-item.scss b/scss/utilities/mixins/accordions/_accordion-list-item.scss
index f281bd31d..1f3856d0d 100644
--- a/scss/utilities/mixins/accordions/_accordion-list-item.scss
+++ b/scss/utilities/mixins/accordions/_accordion-list-item.scss
@@ -3,7 +3,9 @@
//
// @accordion-list-item
//
-// Styleguide: Mixins.Accordions.accordion-list-item
+// Default styling for list items that appear within an expanded accordion.
+//
+// Style guide: Mixins.Accordions.accordion-list-item
//
@mixin accordion-list-item {
background-color: $color-cool-grey;
diff --git a/scss/utilities/mixins/accordions/_accordion-list.scss b/scss/utilities/mixins/accordions/_accordion-list.scss
index e566e7521..05e377b96 100644
--- a/scss/utilities/mixins/accordions/_accordion-list.scss
+++ b/scss/utilities/mixins/accordions/_accordion-list.scss
@@ -3,7 +3,9 @@
//
// @accordion-list
//
-// Styleguide: Mixins.Accordions.accordion-list
+// Default styling for an expanded accordion that includes a list.
+//
+// Style guide: Mixins.Accordions.accordion-list
//
@mixin accordion-list {
@include list-unstyled;
diff --git a/scss/utilities/mixins/accordions/_accordion-nested-list.scss b/scss/utilities/mixins/accordions/_accordion-nested-list.scss
index fe6b9d9e1..5dba83423 100644
--- a/scss/utilities/mixins/accordions/_accordion-nested-list.scss
+++ b/scss/utilities/mixins/accordions/_accordion-nested-list.scss
@@ -3,7 +3,9 @@
//
// @accordion-nested-list
//
-// Styleguide: Mixins.Accordions.accordion-nested-list
+// Default styling for nested lists within an expanded accordion.
+//
+// Style guide: Mixins.Accordions.accordion-nested-list
//
@mixin accordion-nested-list {
> ul li ul {
diff --git a/scss/utilities/mixins/accordions/index.scss b/scss/utilities/mixins/accordions/index.scss
index 22be30001..fb06bf8df 100644
--- a/scss/utilities/mixins/accordions/index.scss
+++ b/scss/utilities/mixins/accordions/index.scss
@@ -1,8 +1,12 @@
@charset "UTF-8";
-///
-/// ROLL UP
-///
+//
+// Accordions
+//
+// Mixins for Accordions
+//
+// Style guide: Mixins.Accordions
+//
@import
'accordion-bordered',
diff --git a/scss/utilities/mixins/alerts/_alerts-icons-colors.scss b/scss/utilities/mixins/alerts/_alerts-icons-colors.scss
index c89c87dab..a79b238fd 100644
--- a/scss/utilities/mixins/alerts/_alerts-icons-colors.scss
+++ b/scss/utilities/mixins/alerts/_alerts-icons-colors.scss
@@ -3,7 +3,9 @@
//
// @alerts-icons-colors
//
-// Styleguide: Mixins.Alerts.alerts-icons-colors
+// Loops through color option settings for Alets component.
+//
+// Style guide: Mixins.Alerts.alerts-icons-colors
//
@mixin alerts-icons-colors {
@each $name, $bgcolor in $alerts {
diff --git a/scss/utilities/mixins/alerts/_alerts.scss b/scss/utilities/mixins/alerts/_alerts.scss
index f6434d60f..2cb2e9ad6 100644
--- a/scss/utilities/mixins/alerts/_alerts.scss
+++ b/scss/utilities/mixins/alerts/_alerts.scss
@@ -3,10 +3,14 @@
//
// @alerts
//
-// Styleguide: Mixins.Alerts.alerts
+// For displaying a notification that keeps people informed
+// of a status, or for displaying a validation message that
+// alerts someone of an important piece of information.
+//
+// Style guide: Mixins.Alerts.alerts
//
@mixin alerts {
- background-color: $color-cool-grey;
+ background-color: $color-fog;
background-position: 1rem 2rem;
background-repeat: no-repeat;
background-size: 4rem;
diff --git a/scss/utilities/mixins/alerts/index.scss b/scss/utilities/mixins/alerts/index.scss
index ed64b46df..983df1994 100644
--- a/scss/utilities/mixins/alerts/index.scss
+++ b/scss/utilities/mixins/alerts/index.scss
@@ -1,8 +1,12 @@
@charset "UTF-8";
-///
-/// ROLL UP
-///
+//
+// Alerts
+//
+// Mixins for Alerts
+//
+// Style guide: Mixins.Alerts
+//
@import
'alerts-icons-colors',
diff --git a/scss/utilities/mixins/banners/_hero-banner.scss b/scss/utilities/mixins/banners/_hero-banner.scss
deleted file mode 100644
index 6e43d7717..000000000
--- a/scss/utilities/mixins/banners/_hero-banner.scss
+++ /dev/null
@@ -1,38 +0,0 @@
-@charset "UTF-8";
-
-//
-// @hero-banner
-//
-// Styleguide: Mixins.Banners.hero-banner
-//
-@mixin hero-banner {
- @include padding($site-margins null);
-
- background-image: url("#{$image-path}/hero-banner.png");
- background-position: center;
- background-size: cover;
-
- .decanter-button {
- color: $color-white;
- }
-
- .decanter-hero-banner__callout {
- background-color: $color-white;
-
- @include padding(3rem);
-
- @include media($small-screen) {
- max-width: 30rem;
- }
-
-
- > *:first-child {
- @include margin(0 null $site-margins null);
- }
-
- .decanter-button {
- @include margin(3rem null null);
- width: 100%;
- }
- }
-}
diff --git a/scss/utilities/mixins/banners/index.scss b/scss/utilities/mixins/banners/index.scss
deleted file mode 100644
index ee768baad..000000000
--- a/scss/utilities/mixins/banners/index.scss
+++ /dev/null
@@ -1,8 +0,0 @@
-@charset "UTF-8";
-
-///
-/// ROLL UP
-///
-
-@import
- 'hero-banner';
diff --git a/scss/utilities/mixins/buttons/_button-big.scss b/scss/utilities/mixins/buttons/_button-big.scss
index 656e9767b..8307f11c9 100644
--- a/scss/utilities/mixins/buttons/_button-big.scss
+++ b/scss/utilities/mixins/buttons/_button-big.scss
@@ -3,7 +3,9 @@
//
// @button-big
//
-// Styleguide: Mixins.Buttons.button-big
+// Big button styling.
+//
+// Style guide: Mixins.Buttons.button-big
//
@mixin button-big {
@include font-smoothing;
diff --git a/scss/utilities/mixins/buttons/_button-primary.scss b/scss/utilities/mixins/buttons/_button-primary.scss
index 7fe9d6cb4..f25d98a20 100644
--- a/scss/utilities/mixins/buttons/_button-primary.scss
+++ b/scss/utilities/mixins/buttons/_button-primary.scss
@@ -3,7 +3,9 @@
//
// @button-primary
//
-// Styleguide: Mixins.Buttons.button-primary
+// Primary (default) button styling.
+//
+// Style guide: Mixins.Buttons.button-primary
//
@mixin button-primary {
@include font-smoothing;
diff --git a/scss/utilities/mixins/buttons/_button-secondary.scss b/scss/utilities/mixins/buttons/_button-secondary.scss
index 9d89e1a7e..5386692f3 100644
--- a/scss/utilities/mixins/buttons/_button-secondary.scss
+++ b/scss/utilities/mixins/buttons/_button-secondary.scss
@@ -3,7 +3,9 @@
//
// @button-secondary
//
-// Styleguide: Mixins.Buttons.button-secondary
+// Secondary button styling.
+//
+// Style guide: Mixins.Buttons.button-secondary
//
@mixin button-secondary {
@include font-smoothing;
diff --git a/scss/utilities/mixins/buttons/_button-unstyled.scss b/scss/utilities/mixins/buttons/_button-unstyled.scss
index 50f8b6bb4..f6f3dedd4 100644
--- a/scss/utilities/mixins/buttons/_button-unstyled.scss
+++ b/scss/utilities/mixins/buttons/_button-unstyled.scss
@@ -3,7 +3,9 @@
//
// @button-unstyled
//
-// Styleguide: Mixins.Buttons.button-unstyled
+// Removes styling from a button.
+//
+// Style guide: Mixins.Buttons.button-unstyled
//
@mixin button-unstyled {
background-color: transparent;
diff --git a/scss/utilities/mixins/buttons/index.scss b/scss/utilities/mixins/buttons/index.scss
index 7a0d865db..d925bf4f6 100644
--- a/scss/utilities/mixins/buttons/index.scss
+++ b/scss/utilities/mixins/buttons/index.scss
@@ -1,8 +1,12 @@
@charset "UTF-8";
-///
-/// ROLL UP
-///
+//
+// Buttons
+//
+// Mixins for Buttons
+//
+// Style guide: Mixins.Buttons
+//
@import
'button-big',
diff --git a/scss/utilities/mixins/display/_display-icon.scss b/scss/utilities/mixins/display/_display-icon.scss
index 9c338d561..3f23cbd39 100644
--- a/scss/utilities/mixins/display/_display-icon.scss
+++ b/scss/utilities/mixins/display/_display-icon.scss
@@ -3,8 +3,9 @@
//
// @display-icon($icon, $direction, $size, $margin, $hover)
//
-// TODO: Description
-//
+// @TODO Needs to be documented. Should this be reworked for asset
+// management purposes?
+//
// Usage: `@include display-icon($icon, $direction, $size, $margin, $hover);`
//
// $icon - todo
@@ -13,7 +14,7 @@
// $margin - todo
// $hover - todo
//
-// Styleguide: Mixins.Display.display-icon
+// Style guide: Mixins.Display.display-icon
//
@mixin display-icon($icon, $direction, $size, $margin, $hover) {
&::#{$direction} {
diff --git a/scss/utilities/mixins/display/_embed-container.scss b/scss/utilities/mixins/display/_embed-container.scss
index 759bb3abe..925a37161 100644
--- a/scss/utilities/mixins/display/_embed-container.scss
+++ b/scss/utilities/mixins/display/_embed-container.scss
@@ -3,12 +3,13 @@
//
// @embed-container($height, $width)
//
-// TODO: Description
+// Responsive embed container to ensure that contents scale to the
+// width of parent element while retaining an aspect ratio of 16:9.
//
// $height - height in pixel integers
// $width - width in pixel integers
//
-// Styleguide: Mixins.Display.embed-container
+// Style guide: Mixins.Display.embed-container
//
@mixin embed-container($height, $width) {
@include padding(null null percentage($height / $width));
diff --git a/scss/utilities/mixins/display/_media-block-img.scss b/scss/utilities/mixins/display/_media-block-img.scss
index 30ad30012..91f3a8f52 100644
--- a/scss/utilities/mixins/display/_media-block-img.scss
+++ b/scss/utilities/mixins/display/_media-block-img.scss
@@ -3,11 +3,12 @@
//
// @media-block-img($margin-right)
//
-// TODO: Description
+// Floats an image to the left and provides a specified margin right. To be used
+// when floating images alongside other content.
//
// $margin-right - Pixel integers
//
-// Styleguide: Mixins.Display.media-block-img
+// Style guide: Mixins.Display.media-block-img
//
@mixin media-block-img($margin-right: 1rem) {
float: left;
diff --git a/scss/utilities/mixins/display/_overflow.scss b/scss/utilities/mixins/display/_overflow.scss
new file mode 100644
index 000000000..a3a4fff93
--- /dev/null
+++ b/scss/utilities/mixins/display/_overflow.scss
@@ -0,0 +1,14 @@
+@charset "UTF-8";
+
+//
+// @overflow($property)
+//
+// Specifies what should happen if content overflows an element's box.
+//
+// $property - visible (web default), scroll, hidden (mixin default), auto
+//
+// Style guide: Mixins.Display.overflow
+//
+@mixin overflow($property: hidden) {
+ overflow: $property;
+}
diff --git a/scss/utilities/mixins/display/index.scss b/scss/utilities/mixins/display/index.scss
index 23c2e06b9..e84e657f5 100644
--- a/scss/utilities/mixins/display/index.scss
+++ b/scss/utilities/mixins/display/index.scss
@@ -1,10 +1,15 @@
@charset "UTF-8";
-///
-/// ROLL UP
-///
+//
+// Display
+//
+// Mixins for Display
+//
+// Style guide: Mixins.Display
+//
@import
'display-icon',
'embed-container',
- 'media-block-img';
+ 'media-block-img',
+ 'overflow';
diff --git a/scss/utilities/mixins/grid/_allow-layout-classes.scss b/scss/utilities/mixins/grid/_allow-layout-classes.scss
index 29ac0fabf..c54e58014 100644
--- a/scss/utilities/mixins/grid/_allow-layout-classes.scss
+++ b/scss/utilities/mixins/grid/_allow-layout-classes.scss
@@ -5,7 +5,7 @@
//
// Allow Layout Classes. Content size helpers.
//
-// Styleguide: Mixins.Grid.allow-layout-classes
+// Style guide: Mixins.Grid.allow-layout-classes
//
@mixin allow-layout-classes {
@include margin(null auto);
diff --git a/scss/utilities/mixins/grid/index.scss b/scss/utilities/mixins/grid/index.scss
index ebdd9a3e7..9481568ce 100644
--- a/scss/utilities/mixins/grid/index.scss
+++ b/scss/utilities/mixins/grid/index.scss
@@ -3,9 +3,9 @@
//
// Grid
//
-// Grid system mixins.
+// Mixins for Grid
//
-// Styleguide: Mixins.Grid
+// Style guide: Mixins.Grid
//
@import
diff --git a/scss/utilities/mixins/icon-grid/_icon-grid.scss b/scss/utilities/mixins/icon-grid/_icon-grid.scss
index 40e961d0f..31d88cc6d 100644
--- a/scss/utilities/mixins/icon-grid/_icon-grid.scss
+++ b/scss/utilities/mixins/icon-grid/_icon-grid.scss
@@ -1,11 +1,11 @@
@charset "UTF-8";
//
-// Icon Grid
+// @icon-grid
//
-// Todo: Description.
+// Grid of icons (or images) with text.
//
-// Styleguide: Mixins.icon-grid
+// Style guide: Mixins.icon-grid
//
@mixin icon-grid {
.decanter-icon-grid__row {
diff --git a/scss/utilities/mixins/index.scss b/scss/utilities/mixins/index.scss
index f11dce135..39b45e4a0 100644
--- a/scss/utilities/mixins/index.scss
+++ b/scss/utilities/mixins/index.scss
@@ -8,7 +8,6 @@
'accessibility/index',
'accordions/index',
'alerts/index',
- 'banners/index',
'buttons/index',
'display/index',
'grid/index',
diff --git a/scss/utilities/mixins/links/_external-link.scss b/scss/utilities/mixins/links/_external-link.scss
index 614272d65..622749bc1 100644
--- a/scss/utilities/mixins/links/_external-link.scss
+++ b/scss/utilities/mixins/links/_external-link.scss
@@ -1,9 +1,12 @@
@charset "UTF-8";
//
-// External Link
+// @external-link($external-link, $external-link-hover)
+//
+// Default external link styling, with external icon.
+//
+// Style guide: Mixins.Links.external-link
//
-
@mixin external-link($external-link, $external-link-hover) {
&::after {
background: url("#{$image-path}/#{$external-link}.png") no-repeat 0 0;
diff --git a/scss/utilities/mixins/links/_link.scss b/scss/utilities/mixins/links/_link.scss
index ded3e175f..8108bf5bf 100644
--- a/scss/utilities/mixins/links/_link.scss
+++ b/scss/utilities/mixins/links/_link.scss
@@ -1,9 +1,12 @@
@charset "UTF-8";
//
-// Link
+// @link
+//
+// Default link styling.
+//
+// Style guide: Mixins.Links.link
//
-
@mixin link {
color: $color-bright-red;
text-decoration: underline;
diff --git a/scss/utilities/mixins/links/_more-link.scss b/scss/utilities/mixins/links/_more-link.scss
index 2ac187b4c..b78a22f79 100644
--- a/scss/utilities/mixins/links/_more-link.scss
+++ b/scss/utilities/mixins/links/_more-link.scss
@@ -1,9 +1,12 @@
@charset "UTF-8";
//
-// More Link
+// @more-link($more-link, $more-link-hover)
+//
+// Default more link styling, with raquo.
+//
+// Style guide: Mixins.Links.more-link
//
-
@mixin more-link($more-link, $more-link-hover) {
&::after {
color: $color-bright-red;
diff --git a/scss/utilities/mixins/links/index.scss b/scss/utilities/mixins/links/index.scss
index d4bcc83fd..ce7e4e5d0 100644
--- a/scss/utilities/mixins/links/index.scss
+++ b/scss/utilities/mixins/links/index.scss
@@ -1,8 +1,12 @@
@charset "UTF-8";
-///
-/// ROLL UP
-///
+//
+// Links
+//
+// Mixins for Links
+//
+// Style guide: Mixins.Links
+//
@import
'external-link',
diff --git a/scss/utilities/mixins/lists/_list-unstyled.scss b/scss/utilities/mixins/lists/_list-unstyled.scss
index ec949715e..74507242b 100644
--- a/scss/utilities/mixins/lists/_list-unstyled.scss
+++ b/scss/utilities/mixins/lists/_list-unstyled.scss
@@ -1,9 +1,12 @@
@charset "UTF-8";
//
-// List Unstyled
+// @list-unstyled
+//
+// Removes styles from a list.
+//
+// Style guide: Mixins.Lists.list-unstyled
//
-
@mixin list-unstyled {
@include margin(0 null);
@include padding(null null null 0);
diff --git a/scss/utilities/mixins/lists/index.scss b/scss/utilities/mixins/lists/index.scss
index 54894e0ef..c3f7758ba 100644
--- a/scss/utilities/mixins/lists/index.scss
+++ b/scss/utilities/mixins/lists/index.scss
@@ -1,8 +1,12 @@
@charset "UTF-8";
-///
-/// ROLL UP
-///
+//
+// Lists
+//
+// Mixins for Lists
+//
+// Style guide: Mixins.Lists
+//
@import
'list-unstyled';
diff --git a/scss/utilities/mixins/menus/_main-menu.scss b/scss/utilities/mixins/menus/_main-menu.scss
index 3037357f6..a810c0ddb 100644
--- a/scss/utilities/mixins/menus/_main-menu.scss
+++ b/scss/utilities/mixins/menus/_main-menu.scss
@@ -1,9 +1,12 @@
@charset "UTF-8";
//
-// Main Menu
+// @main-menu
+//
+// For use with main navigation that does or does not support drop downs.
+//
+// Style guide: Mixins.Menus.main-menu
//
-
@mixin main-menu {
width: 100%;
z-index: $z-index-main-menu;
diff --git a/scss/utilities/mixins/menus/_megamenu.scss b/scss/utilities/mixins/menus/_megamenu.scss
index b1c3a0b5c..6e1759bb6 100644
--- a/scss/utilities/mixins/menus/_megamenu.scss
+++ b/scss/utilities/mixins/menus/_megamenu.scss
@@ -1,9 +1,14 @@
@charset "UTF-8";
//
-// Mega Menu
+// @megamenu
+//
+// An expandable menu in which choices are displayed in a two-dimensional
+// dropdown layout. Excellent design choice for accommodating a large number of
+// options or for revealing lower-level site pages at a glance.
+//
+// Style guide: Mixins.Menus.megamenu
//
-
@mixin megamenu {
@include media($nav-width) {
@include padding(3.15rem null);
diff --git a/scss/utilities/mixins/menus/_outer-megamenu.scss b/scss/utilities/mixins/menus/_outer-megamenu.scss
index 8eec5ec61..bf1419e1d 100644
--- a/scss/utilities/mixins/menus/_outer-megamenu.scss
+++ b/scss/utilities/mixins/menus/_outer-megamenu.scss
@@ -1,9 +1,12 @@
@charset "UTF-8";
//
-// Outter Mega Menu
+// @outer-megamenu
+//
+// @TODO Needs to be documented.
+//
+// Style guide: Mixins.Menus.outter-megamenu
//
-
@mixin outer-megamenu {
background-color: $color-bright-red;
content: '';
diff --git a/scss/utilities/mixins/menus/_sidenav-list.scss b/scss/utilities/mixins/menus/_sidenav-list.scss
index 85723c51e..65d2ba935 100644
--- a/scss/utilities/mixins/menus/_sidenav-list.scss
+++ b/scss/utilities/mixins/menus/_sidenav-list.scss
@@ -1,9 +1,12 @@
@charset "UTF-8";
//
-// Sidenav List
+// @sidenav-list
+//
+// Default styling for a side navigation list.
+//
+// Style guide: Mixins.Menus.subnav-list
//
-
@mixin sidenav-list {
@include list-unstyled;
diff --git a/scss/utilities/mixins/menus/_sidenav-sublist.scss b/scss/utilities/mixins/menus/_sidenav-sublist.scss
index 07c7bc846..57fb57e01 100644
--- a/scss/utilities/mixins/menus/_sidenav-sublist.scss
+++ b/scss/utilities/mixins/menus/_sidenav-sublist.scss
@@ -1,9 +1,12 @@
@charset "UTF-8";
//
-// Sidenav Sublist
+// @sidenav-sublist
+//
+// For styling a sublist of a side navaition menu.
+//
+// Style guide: Mixins.Menus.sidenav-sublist
//
-
@mixin sidenav-sublist {
@include list-unstyled;
@include margin(0);
diff --git a/scss/utilities/mixins/menus/index.scss b/scss/utilities/mixins/menus/index.scss
index 92ab74649..632f32837 100644
--- a/scss/utilities/mixins/menus/index.scss
+++ b/scss/utilities/mixins/menus/index.scss
@@ -1,8 +1,12 @@
@charset "UTF-8";
-///
-/// ROLL UP
-///
+//
+// Menus
+//
+// Mixins for Menus
+//
+// Style guide: Mixins.Menus
+//
@import
'main-menu',
diff --git a/scss/utilities/mixins/navigation/_nav-border.scss b/scss/utilities/mixins/navigation/_nav-border.scss
index ad274f541..d877aaac4 100644
--- a/scss/utilities/mixins/navigation/_nav-border.scss
+++ b/scss/utilities/mixins/navigation/_nav-border.scss
@@ -1,9 +1,12 @@
@charset "UTF-8";
//
-// Navigation Border
+// @nav-border
+//
+// For applying a border to navigation.
+//
+// Style guide: Mixins.Navigation.nav-border
//
-
@mixin nav-border {
border-bottom: 0.2rem solid $color-black;
diff --git a/scss/utilities/mixins/navigation/_nav-close.scss b/scss/utilities/mixins/navigation/_nav-close.scss
index 644f66499..fee03142b 100644
--- a/scss/utilities/mixins/navigation/_nav-close.scss
+++ b/scss/utilities/mixins/navigation/_nav-close.scss
@@ -1,9 +1,12 @@
@charset "UTF-8";
//
-// Navigation Close Button
+// @nav-close
+//
+// Close button for mobile navigation.
+//
+// Style guide: Mixins.Navigation.nav-close
//
-
@mixin nav-close {
@include button-unstyled;
@include margin((-1.2rem) -1.5rem 2.4rem auto);
diff --git a/scss/utilities/mixins/navigation/_nav-overlay.scss b/scss/utilities/mixins/navigation/_nav-overlay.scss
index de3c0d5ef..402850687 100644
--- a/scss/utilities/mixins/navigation/_nav-overlay.scss
+++ b/scss/utilities/mixins/navigation/_nav-overlay.scss
@@ -1,9 +1,12 @@
@charset "UTF-8";
//
-// Navigation Overlay
+// @nav-overlay
+//
+// Screen overlay for when mobile nav is exposed.
+//
+// Style guide: Mixins.Navigation.nav-overlay
//
-
@mixin nav-overlay {
@include position(fixed, 0);
diff --git a/scss/utilities/mixins/navigation/index.scss b/scss/utilities/mixins/navigation/index.scss
index e1b216083..1179cc312 100644
--- a/scss/utilities/mixins/navigation/index.scss
+++ b/scss/utilities/mixins/navigation/index.scss
@@ -1,8 +1,12 @@
@charset "UTF-8";
-///
-/// ROLL UP
-///
+//
+// Navigation
+//
+// Mixins for Navigation
+//
+// Style guide: Mixins.Navigation
+//
@import
'nav-border',
diff --git a/scss/utilities/mixins/tables/_table-borderless.scss b/scss/utilities/mixins/tables/_table-borderless.scss
index da16799ca..065b82637 100644
--- a/scss/utilities/mixins/tables/_table-borderless.scss
+++ b/scss/utilities/mixins/tables/_table-borderless.scss
@@ -1,9 +1,12 @@
@charset "UTF-8";
//
-// Table Borderless
+// @table-borderless
+//
+// Tables without borders styling.
+//
+// Style guide: Mixins.Tables.table-borderless
//
-
@mixin table-borderless {
thead {
tr {
diff --git a/scss/utilities/mixins/tables/_tables.scss b/scss/utilities/mixins/tables/_tables.scss
index 69a4d9a82..cd8c2a0b2 100644
--- a/scss/utilities/mixins/tables/_tables.scss
+++ b/scss/utilities/mixins/tables/_tables.scss
@@ -1,9 +1,12 @@
@charset "UTF-8";
//
-// Tables
+// @tables
+//
+// Default table styling.
+//
+// Style guide: Mixins.Tables.tables
//
-
@mixin tables {
border-spacing: 0;
min-width: 100%;
diff --git a/scss/utilities/mixins/tables/index.scss b/scss/utilities/mixins/tables/index.scss
index eb926cdf3..de573f407 100644
--- a/scss/utilities/mixins/tables/index.scss
+++ b/scss/utilities/mixins/tables/index.scss
@@ -1,8 +1,12 @@
@charset "UTF-8";
-///
-/// ROLL UP
-///
+//
+// Tables
+//
+// Mixins for Tables
+//
+// Style guide: Mixins.Tables
+//
@import
'table-borderless',
diff --git a/scss/utilities/mixins/typography/_caption.scss b/scss/utilities/mixins/typography/_caption.scss
index 5af0aa3ac..7fe3f17bc 100644
--- a/scss/utilities/mixins/typography/_caption.scss
+++ b/scss/utilities/mixins/typography/_caption.scss
@@ -1,9 +1,12 @@
@charset "UTF-8";
//
-// Caption
+// @caption
+//
+// To be used for describing the content of an image.
+//
+// Style guide: Mixins.Typography.caption
//
-
@mixin caption {
color: $color-cool-grey;
font-size: $small-font-size;
diff --git a/scss/utilities/mixins/typography/_credits.scss b/scss/utilities/mixins/typography/_credits.scss
index 517537878..b5169b788 100644
--- a/scss/utilities/mixins/typography/_credits.scss
+++ b/scss/utilities/mixins/typography/_credits.scss
@@ -1,9 +1,12 @@
@charset "UTF-8";
//
-// Credits
+// @credits
+//
+// To be used for crediting a source or photographer.
+//
+// Style guide: Mixins.Typography.credits
//
-
@mixin credits {
color: $color-cool-grey;
font-size: $small-font-size;
diff --git a/scss/utilities/mixins/typography/_font-lead.scss b/scss/utilities/mixins/typography/_font-lead.scss
index 0c8f36394..38bf9ebd5 100644
--- a/scss/utilities/mixins/typography/_font-lead.scss
+++ b/scss/utilities/mixins/typography/_font-lead.scss
@@ -1,9 +1,13 @@
@charset "UTF-8";
//
-// Font Lead
+// @font-lead
+//
+// For leading a page of text, summarizing a main point, and/or highlighting a
+// paragraph or quote.
+//
+// Style guide: Mixins.Typography.font-lead
//
-
@mixin font-lead {
font-family: $font-sans;
font-size: $lead-font-size;
diff --git a/scss/utilities/mixins/typography/_font-smoothing.scss b/scss/utilities/mixins/typography/_font-smoothing.scss
index 53939ab1c..d37ef02f5 100644
--- a/scss/utilities/mixins/typography/_font-smoothing.scss
+++ b/scss/utilities/mixins/typography/_font-smoothing.scss
@@ -1,11 +1,12 @@
@charset "UTF-8";
//
-// Font Smoothing
+// @font-smoothing
//
-
// To be used for light text on a dark background only.
-
+//
+// Style guide: Mixins.Typography.font-smoothing
+//
@mixin font-smoothing {
-moz-osx-font-smoothing: grayscale;
-webkit-font-smoothing: antialiased;
diff --git a/scss/utilities/mixins/typography/_font-splash.scss b/scss/utilities/mixins/typography/_font-splash.scss
index c1b4e5789..4bd170a62 100644
--- a/scss/utilities/mixins/typography/_font-splash.scss
+++ b/scss/utilities/mixins/typography/_font-splash.scss
@@ -1,9 +1,12 @@
@charset "UTF-8";
//
-// Font Splash
+// @font-splash
+//
+// For text on a page that should stand out and draw more attention.
+//
+// Style guide: Mixins.Typography.font-splash
//
-
@mixin font-splash {
@include h3;
@include margin(null null 0);
@@ -13,6 +16,7 @@
}
@include media($medium-screen) {
- @include title;
+ font-size: $splash-font-size;
+ font-weight: $font-bold;
}
}
diff --git a/scss/utilities/mixins/typography/_h1.scss b/scss/utilities/mixins/typography/_h1.scss
index 448362d58..54f21e69c 100644
--- a/scss/utilities/mixins/typography/_h1.scss
+++ b/scss/utilities/mixins/typography/_h1.scss
@@ -1,9 +1,12 @@
@charset "UTF-8";
//
-// Heading 1
+// @h1
+//
+// Default heading 1 styling.
+//
+// Style guide: Mixins.Typography.h1
//
-
@mixin h1 {
font-size: $h1-font-size;
font-weight: $font-bold;
diff --git a/scss/utilities/mixins/typography/_h2.scss b/scss/utilities/mixins/typography/_h2.scss
index 17d76292e..7442d753f 100644
--- a/scss/utilities/mixins/typography/_h2.scss
+++ b/scss/utilities/mixins/typography/_h2.scss
@@ -1,9 +1,12 @@
@charset "UTF-8";
//
-// Heading 2
+// @h2
+//
+// Default heading 2 styling.
+//
+// Style guide: Mixins.Typography.h2
//
-
@mixin h2 {
font-size: $h2-font-size;
font-weight: $font-bold;
diff --git a/scss/utilities/mixins/typography/_h3.scss b/scss/utilities/mixins/typography/_h3.scss
index 39b37738d..99905a39a 100644
--- a/scss/utilities/mixins/typography/_h3.scss
+++ b/scss/utilities/mixins/typography/_h3.scss
@@ -1,9 +1,12 @@
@charset "UTF-8";
//
-// Heading 3
+// @h3
+//
+// Default heading 3 styling.
+//
+// Style guide: Mixins.Typography.h3
//
-
@mixin h3 {
font-size: $h3-font-size;
font-weight: $font-bold;
diff --git a/scss/utilities/mixins/typography/_h4.scss b/scss/utilities/mixins/typography/_h4.scss
index da78bb46c..394c1cb90 100644
--- a/scss/utilities/mixins/typography/_h4.scss
+++ b/scss/utilities/mixins/typography/_h4.scss
@@ -1,9 +1,12 @@
@charset "UTF-8";
//
-// Heading 4
+// @h4
+//
+// Default heading 4 styling.
+//
+// Style guide: Mixins.Typography.h4
//
-
@mixin h4 {
font-size: $h4-font-size;
font-weight: $font-bold;
diff --git a/scss/utilities/mixins/typography/_h5.scss b/scss/utilities/mixins/typography/_h5.scss
index a70514a60..3ecaa5e41 100644
--- a/scss/utilities/mixins/typography/_h5.scss
+++ b/scss/utilities/mixins/typography/_h5.scss
@@ -1,9 +1,12 @@
@charset "UTF-8";
//
-// Heading 5
+// @h5
+//
+// Default heading 5 styling.
+//
+// Style guide: Mixins.Typography.h5
//
-
@mixin h5 {
font-size: $h5-font-size;
font-weight: $font-bold;
diff --git a/scss/utilities/mixins/typography/_h6.scss b/scss/utilities/mixins/typography/_h6.scss
index e47f995c1..aee5bf9bc 100644
--- a/scss/utilities/mixins/typography/_h6.scss
+++ b/scss/utilities/mixins/typography/_h6.scss
@@ -1,9 +1,12 @@
@charset "UTF-8";
//
-// Heading 6
+// @h6
+//
+// Default heading 6 styling.
+//
+// Style guide: Mixins.Typography.h6
//
-
@mixin h6 {
font-family: $font-sans;
font-size: $h6-font-size;
diff --git a/scss/utilities/mixins/typography/_headings.scss b/scss/utilities/mixins/typography/_headings.scss
index 397a559ae..70621b105 100644
--- a/scss/utilities/mixins/typography/_headings.scss
+++ b/scss/utilities/mixins/typography/_headings.scss
@@ -1,9 +1,12 @@
@charset "UTF-8";
//
-// Headings
+// @headings
+//
+// Default heading shared styling.
+//
+// Style guide: Mixins.Typography.headings
//
-
@mixin headings {
clear: both;
font-family: $font-sans;
diff --git a/scss/utilities/mixins/typography/_sans.scss b/scss/utilities/mixins/typography/_sans.scss
index 0d8593820..df24773d4 100644
--- a/scss/utilities/mixins/typography/_sans.scss
+++ b/scss/utilities/mixins/typography/_sans.scss
@@ -1,9 +1,12 @@
@charset "UTF-8";
//
-// Sans Serif Font
+// @sans
+//
+// Sans Serfif font styling.
+//
+// Style guide: Mixins.Typography.sans
//
-
@mixin sans {
p,
a,
diff --git a/scss/utilities/mixins/typography/_serif.scss b/scss/utilities/mixins/typography/_serif.scss
index 8b475e3e4..b465e93ee 100644
--- a/scss/utilities/mixins/typography/_serif.scss
+++ b/scss/utilities/mixins/typography/_serif.scss
@@ -1,9 +1,12 @@
@charset "UTF-8";
//
-// Serif Font
+// @serif
+//
+// Serif font styling.
+//
+// Style guide: Mixins.Typography.serif
//
-
@mixin serif {
p,
a,
diff --git a/scss/utilities/mixins/typography/_short-line-length.scss b/scss/utilities/mixins/typography/_short-line-length.scss
index 90eb66f3a..103c32cb9 100644
--- a/scss/utilities/mixins/typography/_short-line-length.scss
+++ b/scss/utilities/mixins/typography/_short-line-length.scss
@@ -1,9 +1,13 @@
@charset "UTF-8";
//
-// Short Line Length
+// @short-line-length
+//
+// For reducing the length of lines in a paragraph, no matter the width of its
+// container.
+//
+// Style guide: Mixins.Typography.short-line-length
//
-
@mixin short-line-length {
max-width: $text-max-width;
}
diff --git a/scss/utilities/mixins/typography/_slab.scss b/scss/utilities/mixins/typography/_slab.scss
index a32a4f37b..0bc5bd382 100644
--- a/scss/utilities/mixins/typography/_slab.scss
+++ b/scss/utilities/mixins/typography/_slab.scss
@@ -1,9 +1,12 @@
@charset "UTF-8";
//
-// Slab Font
+// @slab
+//
+// Slab font styling.
+//
+// Style guide: Mixins.Typography.slab
//
-
@mixin slab {
p,
a,
diff --git a/scss/utilities/mixins/typography/_title.scss b/scss/utilities/mixins/typography/_title.scss
deleted file mode 100644
index 0ac842700..000000000
--- a/scss/utilities/mixins/typography/_title.scss
+++ /dev/null
@@ -1,10 +0,0 @@
-@charset "UTF-8";
-
-//
-// Title
-//
-
-@mixin title {
- font-size: $title-font-size;
- font-weight: $font-bold;
-}
diff --git a/scss/utilities/mixins/typography/index.scss b/scss/utilities/mixins/typography/index.scss
index 6500229a5..5f76f0b3c 100644
--- a/scss/utilities/mixins/typography/index.scss
+++ b/scss/utilities/mixins/typography/index.scss
@@ -1,8 +1,12 @@
@charset "UTF-8";
-///
-/// ROLL UP
-///
+//
+// Typography
+//
+// Mixins for Typography
+//
+// Style guide: Mixins.Typography
+//
@import
'caption',
@@ -20,5 +24,4 @@
'sans',
'serif',
'short-line-length',
- 'slab',
- 'title';
+ 'slab';
diff --git a/scss/variables/components/_accordions.scss b/scss/variables/components/_accordions.scss
index b7254e7f0..bf8f3836f 100644
--- a/scss/variables/components/_accordions.scss
+++ b/scss/variables/components/_accordions.scss
@@ -3,13 +3,7 @@
//
// Accordions
//
-// Every variable is declared as !default so that it can be
-// overridden by a previous import.
-//
-// If you want to override a variable, set that variable in one of your
-// own partials, then @import '{path/to/}core/variables'.
-//
-// Styleguide: Variables.Accordions
+// Style guide: Variables.Components.Accordions
//
//
@@ -19,6 +13,6 @@
//
// Markup: $accordion-border: 1px solid $color-driftwood !default;
//
-// Styleguide: Variables.Accordions.accordion-border
+// Styleguide: Variables.Components.Accordions.accordion-border
//
$accordion-border: 1px solid $color-driftwood !default;
diff --git a/scss/variables/components/_alerts.scss b/scss/variables/components/_alerts.scss
index 03a332b63..9f062f623 100644
--- a/scss/variables/components/_alerts.scss
+++ b/scss/variables/components/_alerts.scss
@@ -3,23 +3,17 @@
//
// Alerts
//
-// Every variable is declared as !default so that it can be
-// overridden by a previous import.
-//
-// If you want to override a variable, set that variable in one of your
-// own partials, then @import '{path/to/}core/variables'.
-//
-// Styleguide: Variables.Alerts
+// Style guide: Variables.Components.Alerts
//
//
// $decanter-custom-alerts
//
-// TODO: Joe to document this.
+// Color map for custom alert components.
//
// Markup: $decanter-custom-alerts: () !default;
//
-// Styleguide: Variables.Alerts.decanter-custom-alerts
+// Styleguide: Variables.Components.Alerts.decanter-custom-alerts
//
$decanter-custom-alerts: () !default;
@@ -29,28 +23,31 @@ $decanter-custom-alerts: () !default;
// Color map for alert components.
//
// Markup: $decanter-alerts: (
-// success: rgba(23, 94, 84, 0.6), // $color-palo-alto at 60% opacity
-// warning: rgba(234, 171, 0, 0.6), // $color-sun at 60% opacity
-// error: rgba(177, 4, 14, 0.5), // $color-bright-red at 50% opacity
-// info: rgba(0, 152, 219, 0.6), // $color-sky at 60% opacity
+// success: rgba(23, 94, 84, 0.6), // $color-palo-alto at 60% opacity
+// warning: rgba(234, 171, 0, 0.6), // $color-sun at 60% opacity
+// error: rgba(177, 4, 14, 0.5), // $color-bright-red at 50% opacity
+// info: rgba(0, 152, 219, 0.6), // $color-sky at 60% opacity
// );
//
-// Styleguide: Variables.Alerts.decanter-alerts
+// Styleguide: Variables.Components.Alerts.decanter-alerts
//
$decanter-alerts: (
- success: rgba(23, 94, 84, 0.6), // $color-palo-alto at 60% opacity
- warning: rgba(234, 171, 0, 0.6), // $color-sun at 60% opacity
- error: rgba(177, 4, 14, 0.5), // $color-bright-red at 50% opacity
- info: rgba(0, 152, 219, 0.6), // $color-sky at 60% opacity
+ success: rgba(23, 94, 84, 0.6), // $color-palo-alto at 60% opacity
+ warning: rgba(234, 171, 0, 0.6), // $color-sun at 60% opacity
+ error: rgba(177, 4, 14, 0.5), // $color-bright-red at 50% opacity
+ info: rgba(0, 152, 219, 0.6), // $color-sky at 60% opacity
);
//
// $alerts
//
-// TODO: Joe to document this.
+// Merges $decanter-alerts and $decanter-custom-alerts maps into a new, single
+// map.
+// Keys in $decanter-custom-alerts will take precedence over keys in
+// $decanter-alerts. This is the best way to add new values to a map.
//
// Markup: $alerts: map-merge($decanter-alerts, $decanter-custom-alerts);
//
-// Styleguide: Variables.Alerts.alerts
+// Styleguide: Variables.Components.Alerts.alerts
//
$alerts: map-merge($decanter-alerts, $decanter-custom-alerts);
diff --git a/scss/variables/components/_navigation.scss b/scss/variables/components/_navigation.scss
index 5f4a3132c..56c640c99 100644
--- a/scss/variables/components/_navigation.scss
+++ b/scss/variables/components/_navigation.scss
@@ -3,13 +3,7 @@
//
// Navigation
//
-// Every variable is declared as !default so that it can be
-// overridden by a previous import.
-//
-// If you want to override a variable, set that variable in one of your
-// own partials, then @import '{path/to/}core/variables'.
-//
-// Styleguide: Variables.Navigation
+// Style guide: Variables.Components.Navigation
//
//
@@ -19,39 +13,39 @@
//
// Markup: $z-index-nav: 9000 !default;
//
-// Styleguide: Variables.Navigation.z-index-nav
+// Styleguide: Variables.Components.Navigation.z-index-nav
//
$z-index-nav: 9000 !default;
//
// $sliding-panel-width
//
-// TODO: Joe to document.
+// Width of panel that slides open upon the mobile menu being expanded.
//
// Markup: $z-index-nav: 9000 !default;
//
-// Styleguide: Variables.Navigation.sliding-panel-width
+// Styleguide: Variables.Components.Navigation.sliding-panel-width
//
$sliding-panel-width: 26rem !default;
//
// $z-index-main-menu
//
-// TODO: Joe to document.
+// z-index of the main menu.
//
// Markup: $z-index-main-menu: 7000 !default;
//
-// Styleguide: Variables.Navigation.z-index-main-menu
+// Styleguide: Variables.Components.Navigation.z-index-main-menu
//
$z-index-main-menu: 7000 !default;
//
// $z-index-overlay
//
-// TODO: Joe to document.
+// z-index of the main menu overlay in mobile.
//
// Markup: $z-index-overlay: 8000 !default;
//
-// Styleguide: Variables.Navigation.z-index-overlay
+// Styleguide: Variables.Components.Navigation.z-index-overlay
//
$z-index-overlay: 8000 !default;
diff --git a/scss/variables/components/index.scss b/scss/variables/components/index.scss
index af1c3dff5..c7a478d29 100644
--- a/scss/variables/components/index.scss
+++ b/scss/variables/components/index.scss
@@ -1,8 +1,12 @@
@charset "UTF-8";
-///
-/// ROLL UP
-///
+//
+// Components
+//
+// Variables for components.
+//
+// Style guide: Variables.Components
+//
@import
'accordions',
diff --git a/scss/variables/core/_asset-pipeline.scss b/scss/variables/core/_asset-pipeline.scss
index 92655c711..3e93bd525 100644
--- a/scss/variables/core/_asset-pipeline.scss
+++ b/scss/variables/core/_asset-pipeline.scss
@@ -3,15 +3,8 @@
//
// Rails
//
-// Every variable is declared as !default so that it can be
-// overridden by a previous import.
+// Style guide: Variables.Core.Rails
//
-// If you want to override a variable, set that variable in one of your
-// own partials, then @import '{path/to/}core/variables'.
-//
-// Styleguide: Variables.Rails
-//
-
//
// $asset-pipeline
@@ -20,6 +13,6 @@
//
// Markup: $asset-pipeline: false !default;
//
-// Styleguide: Variables.Rails.asset-pipeline
+// Styleguide: Variables.Core.Rails.asset-pipeline
//
$asset-pipeline: false !default;
diff --git a/scss/variables/core/_breakpoints.scss b/scss/variables/core/_breakpoints.scss
index b7a10dc59..398f0b2f6 100644
--- a/scss/variables/core/_breakpoints.scss
+++ b/scss/variables/core/_breakpoints.scss
@@ -3,13 +3,7 @@
//
// Breakpoints
//
-// Every variable is declared as !default so that it can be
-// overridden by a previous import.
-//
-// If you want to override a variable, set that variable in one of your
-// own partials, then @import '{path/to/}core/variables'.
-//
-// Styleguide: Variables.Breakpoints
+// Style guide: Variables.Core.Breakpoints
//
//
@@ -17,16 +11,16 @@
//
// Markup: $small-screen: 481px !default;
//
-// Styleguide: Variables.Breakpoints.small-screen
+// Styleguide: Variables.Core.Breakpoints.small-screen
//
-$small-screen: 481px !default;
+$small-screen: 481px !default;
//
// $medium-screen
//
// Markup: $medium-screen: 600px !default;
//
-// Styleguide: Variables.Breakpoints.medium-screen
+// Styleguide: Variables.Core.Breakpoints.medium-screen
//
$medium-screen: 600px !default;
@@ -35,9 +29,9 @@ $medium-screen: 600px !default;
//
// Markup: $large-screen: 1201px !default;
//
-// Styleguide: Variables.Breakpoints.large-screen
+// Styleguide: Variables.Core.Breakpoints.large-screen
//
-$large-screen: 1201px !default;
+$large-screen: 1201px !default;
//
// $grid-columns-small
@@ -46,9 +40,9 @@ $large-screen: 1201px !default;
//
// Markup: $grid-columns-small: 1 !default;
//
-// Styleguide: Variables.Breakpoints.grid-columns-small
+// Styleguide: Variables.Core.Breakpoints.grid-columns-small
//
-$grid-columns-small: 1 !default;
+$grid-columns-small: 1 !default;
//
// $grid-columns-medium
@@ -57,7 +51,7 @@ $grid-columns-small: 1 !default;
//
// Markup: $grid-columns-medium: 6 !default;
//
-// Styleguide: Variables.Breakpoints.grid-columns-medium
+// Styleguide: Variables.Core.Breakpoints.grid-columns-medium
//
$grid-columns-medium: 6 !default;
@@ -68,9 +62,9 @@ $grid-columns-medium: 6 !default;
//
// Markup: $grid-columns-large: 12 !default;
//
-// Styleguide: Variables.Breakpoints.grid-columns-large
+// Styleguide: Variables.Core.Breakpoints.grid-columns-large
//
-$grid-columns-large: 12 !default;
+$grid-columns-large: 12 !default;
//
// $small
@@ -79,7 +73,7 @@ $grid-columns-large: 12 !default;
//
// Markup: $small: new-breakpoint(min-width $small-screen $grid-columns-small) !default;
//
-// Styleguide: Variables.Breakpoints.small
+// Styleguide: Variables.Core.Breakpoints.small
//
$small: new-breakpoint(min-width $small-screen $grid-columns-small) !default;
@@ -90,7 +84,7 @@ $small: new-breakpoint(min-width $small-screen $grid-columns-small) !default;
//
// Markup: $medium: new-breakpoint(min-width $medium-screen $grid-columns-medium) !default;
//
-// Styleguide: Variables.Breakpoints.medium
+// Styleguide: Variables.Core.Breakpoints.medium
//
$medium: new-breakpoint(min-width $medium-screen $grid-columns-medium) !default;
@@ -101,6 +95,6 @@ $medium: new-breakpoint(min-width $medium-screen $grid-columns-medium) !default;
//
// Markup: $large: new-breakpoint(min-width $large-screen $grid-columns-large) !default;
//
-// Styleguide: Variables.Breakpoints.large
+// Styleguide: Variables.Core.Breakpoints.large
//
$large: new-breakpoint(min-width $large-screen $grid-columns-large) !default;
diff --git a/scss/variables/core/_colors.scss b/scss/variables/core/_colors.scss
index 16613deaf..8477213e2 100644
--- a/scss/variables/core/_colors.scss
+++ b/scss/variables/core/_colors.scss
@@ -3,16 +3,12 @@
//
// Colors
//
-// Every variable is declared as !default so that it can be
-// overridden by a previous import.
-//
-// If you want to override a variable, set that variable in one of your
-// own partials, then @import '{path/to/}core/variables'.
-//
+// Default color palette. Primary colors include Cardinal Red, White, Cool Grey,
+// and Black. All other colors are supporting colors.
// See complete color palette at
// http://identity.stanford.edu/color.html#digital-color.
//
-// Styleguide: Variables.Colors
+// Style guide: Variables.Core.Colors
//
//
@@ -20,277 +16,276 @@
//
// Markup: $color-black: #2e2d29 !default;
//
-// Styleguide: Variables.Colors.black
+// Styleguide: Variables.Core.Colors.black
//
-$color-black: #2e2d29 !default;
+$color-black: #2e2d29 !default;
//
// $color-cardinal-red
//
-// Markup: $color-cardinal-red: #8c1515 !default;
+// Markup: $color-cardinal-red: #8c1515 !default;
//
-// Styleguide: Variables.Colors.color-cardinal-red
+// Styleguide: Variables.Core.Colors.color-cardinal-red
//
-$color-cardinal-red: #8c1515 !default;
+$color-cardinal-red: #8c1515 !default;
//
// $color-cool-grey
//
-// Markup: $color-cool-grey: #4d4f53 !default;
+// Markup: $color-cool-grey: #4d4f53 !default;
//
-// Styleguide: Variables.Colors.color-cool-grey
+// Styleguide: Variables.Core.Colors.color-cool-grey
//
-$color-cool-grey: #4d4f53 !default;
+$color-cool-grey: #4d4f53 !default;
//
// $color-white
//
-// Markup: $color-white: #ffffff !default;
+// Markup: $color-white: #ffffff !default;
//
-// Styleguide: Variables.Colors.color-white
+// Styleguide: Variables.Core.Colors.color-white
//
-$color-white: #ffffff !default;
-
+$color-white: #ffffff !default;
//
// $color-beige
//
-// Markup: $color-beige: #9d9573 !default;
+// Markup: $color-beige: #9d9573 !default;
//
-// Styleguide: Variables.Colors.color-beige
+// Styleguide: Variables.Core.Colors.color-beige
//
-$color-beige: #9d9573 !default;
+$color-beige: #9d9573 !default;
//
// $color-blue
//
-// Markup: $color-blue: #00548f !default;
+// Markup: $color-blue: #00548f !default;
//
-// Styleguide: Variables.Colors.color-blue
+// Styleguide: Variables.Core.Colors.color-blue
//
-$color-blue: #00548f !default;
+$color-blue: #00548f !default;
//
// $color-bright-blue
//
-// Markup: $color-bright-blue: #006cb8 !default;
+// Markup: $color-bright-blue: #006cb8 !default;
//
-// Styleguide: Variables.Colors.color-bright-blue
+// Styleguide: Variables.Core.Colors.color-bright-blue
//
-$color-bright-blue: #006cb8 !default;
+$color-bright-blue: #006cb8 !default;
//
// $color-bright-red
//
-// Markup: $color-bright-red: #b1040e !default;
+// Markup: $color-bright-red: #b1040e !default;
//
-// Styleguide: Variables.Colors.color-bright-red
+// Styleguide: Variables.Core.Colors.color-bright-red
//
-$color-bright-red: #b1040e !default;
+$color-bright-red: #b1040e !default;
//
// $color-brown
//
-// Markup: $color-brown: #5e3032 !default;
+// Markup: $color-brown: #5e3032 !default;
//
-// Styleguide: Variables.Colors.color-brown
+// Styleguide: Variables.Core.Colors.color-brown
//
-$color-brown: #5e3032 !default;
+$color-brown: #5e3032 !default;
//
// $color-chocolate
//
-// Markup: $color-chocolate: #2f2424 !default;
+// Markup: $color-chocolate: #2f2424 !default;
//
-// Styleguide: Variables.Colors.color-chocolate
+// Styleguide: Variables.Core.Colors.color-chocolate
//
-$color-chocolate: #2f2424 !default;
+$color-chocolate: #2f2424 !default;
//
// $color-clay
//
-// Markup: $color-clay: #5f574f !default;
+// Markup: $color-clay: #5f574f !default;
//
-// Styleguide: Variables.Colors.color-clay
+// Styleguide: Variables.Core.Colors.color-clay
//
-$color-clay: #5f574f !default;
+$color-clay: #5f574f !default;
//
// $color-cloud
//
-// Markup: $color-cloud: #dad7cb !default;
+// Markup: $color-cloud: #dad7cb !default;
//
-// Styleguide: Variables.Colors.color-cloud
+// Styleguide: Variables.Core.Colors.color-cloud
//
-$color-cloud: #dad7cb !default;
+$color-cloud: #dad7cb !default;
//
// $color-dark-red
//
-// Markup: $color-dark-red: #820000 !default;
+// Markup: $color-dark-red: #820000 !default;
//
-// Styleguide: Variables.Colors.color-dark-red
+// Styleguide: Variables.Core.Colors.color-dark-red
//
-$color-dark-red: #820000 !default;
+$color-dark-red: #820000 !default;
//
// $color-driftwood
//
-// Markup: $color-driftwood: #b6b1a9 !default;
+// Markup: $color-driftwood: #b6b1a9 !default;
//
-// Styleguide: Variables.Colors.color-driftwood
+// Styleguide: Variables.Core.Colors.color-driftwood
//
-$color-driftwood: #b6b1a9 !default;
+$color-driftwood: #b6b1a9 !default;
//
// $color-fog
//
-// Markup: $color-fog: #f4f4f4 !default;
+// Markup: $color-fog: #f4f4f4 !default;
//
-// Styleguide: Variables.Colors.color-fog
+// Styleguide: Variables.Core.Colors.color-fog
//
-$color-fog: #f4f4f4 !default;
+$color-fog: #f4f4f4 !default;
//
// $color-gold
//
-// Markup: $color-gold: #b26f16 !default;
+// Markup: $color-gold: #b26f16 !default;
//
-// Styleguide: Variables.Colors.color-gold
+// Styleguide: Variables.Core.Colors.color-gold
//
-$color-gold: #b26f16 !default;
+$color-gold: #b26f16 !default;
//
// $color-lagunita
//
-// Markup: $color-lagunita: #007c92 !default;
+// Markup: $color-lagunita: #007c92 !default;
//
-// Styleguide: Variables.Colors.color-lagunita
+// Styleguide: Variables.Core.Colors.color-lagunita
//
-$color-lagunita: #007c92 !default;
+$color-lagunita: #007c92 !default;
//
// $color-light-sage
//
-// Markup: $color-light-sage: #c7d1c5 !default;
+// Markup: $color-light-sage: #c7d1c5 !default;
//
-// Styleguide: Variables.Colors.color-light-sage
+// Styleguide: Variables.Core.Colors.color-light-sage
//
-$color-light-sage: #c7d1c5 !default;
+$color-light-sage: #c7d1c5 !default;
//
// $color-light-sandstone
//
-// Markup: $color-light-sandstone: #f9f6ef !default;
+// Markup: $color-light-sandstone: #f9f6ef !default;
//
-// Styleguide: Variables.Colors.color-light-sandstone
+// Styleguide: Variables.Core.Colors.color-light-sandstone
//
-$color-light-sandstone: #f9f6ef !default;
+$color-light-sandstone: #f9f6ef !default;
//
// $color-mint
//
-// Markup: $color-mint: #009b76 !default;
+// Markup: $color-mint: #009b76 !default;
//
-// Styleguide: Variables.Colors.color-mint
+// Styleguide: Variables.Core.Colors.color-mint
//
-$color-mint: #009b76 !default;
+$color-mint: #009b76 !default;
//
// $color-poppy
//
-// Markup: $color-poppy: #e98300 !default;
+// Markup: $color-poppy: #e98300 !default;
//
-// Styleguide: Variables.Colors.color-poppy
+// Styleguide: Variables.Core.Colors.color-poppy
//
-$color-poppy: #e98300 !default;
+$color-poppy: #e98300 !default;
//
// $color-palo-alto
//
-// Markup: $color-palo-alto: #175e54 !default;
+// Markup: $color-palo-alto: #175e54 !default;
//
-// Styleguide: Variables.Colors.color-palo-alto
+// Styleguide: Variables.Core.Colors.color-palo-alto
//
-$color-palo-alto: #175e54 !default;
+$color-palo-alto: #175e54 !default;
//
// $color-purple
//
-// Markup: $color-purple: #53284f !default;
+// Markup: $color-purple: #53284f !default;
//
-// Styleguide: Variables.Colors.color-purple
+// Styleguide: Variables.Core.Colors.color-purple
//
-$color-purple: #53284f !default;
+$color-purple: #53284f !default;
//
// $color-redwood
//
-// Markup: $color-redwood: #8d3c1e !default;
+// Markup: $color-redwood: #8d3c1e !default;
//
-// Styleguide: Variables.Colors.color-redwood
+// Styleguide: Variables.Core.Colors.color-redwood
//
-$color-redwood: #8d3c1e !default;
+$color-redwood: #8d3c1e !default;
//
// $color-sandhill
//
-// Markup: $color-sandhill: #b3995d !default;
+// Markup: $color-sandhill: #b3995d !default;
//
-// Styleguide: Variables.Colors.color-sandhill
+// Styleguide: Variables.Core.Colors.color-sandhill
//
-$color-sandhill: #b3995d !default;
+$color-sandhill: #b3995d !default;
//
// $color-sandstone
//
-// Markup: $color-sandstone: #d2c295 !default;
+// Markup: $color-sandstone: #d2c295 !default;
//
-// Styleguide: Variables.Colors.color-sandstone
+// Styleguide: Variables.Core.Colors.color-sandstone
//
-$color-sandstone: #d2c295 !default;
+$color-sandstone: #d2c295 !default;
//
// $color-sky
//
-// Markup: $color-sky: #0098db !default;
+// Markup: $color-sky: #0098db !default;
//
-// Styleguide: Variables.Colors.color-sky
+// Styleguide: Variables.Core.Colors.color-sky
//
-$color-sky: #0098db !default;
+$color-sky: #0098db !default;
//
// $color-stone
//
-// Markup: $color-stone: #544948 !default;
+// Markup: $color-stone: #544948 !default;
//
-// Styleguide: Variables.Colors.color-stone
+// Styleguide: Variables.Core.Colors.color-stone
//
-$color-stone: #544948 !default;
+$color-stone: #544948 !default;
//
// $color-sun
//
-// Markup: $color-sun: #eaab00 !default;
+// Markup: $color-sun: #eaab00 !default;
//
-// Styleguide: Variables.Colors.color-sun
+// Styleguide: Variables.Core.Colors.color-sun
//
-$color-sun: #eaab00 !default;
+$color-sun: #eaab00 !default;
//
// $color-teal
//
-// Markup: $color-teal: #00505c !default;
+// Markup: $color-teal: #00505c !default;
//
-// Styleguide: Variables.Colors.color-teal
+// Styleguide: Variables.Core.Colors.color-teal
//
-$color-teal: #00505c !default;
+$color-teal: #00505c !default;
//
// $color-warm-grey
//
-// Markup: $color-warm-grey: #3f3c30 !default;
+// Markup: $color-warm-grey: #3f3c30 !default;
//
-// Styleguide: Variables.Colors.color-warm-grey
+// Styleguide: Variables.Core.Colors.color-warm-grey
//
-$color-warm-grey: #3f3c30 !default;
+$color-warm-grey: #3f3c30 !default;
diff --git a/scss/variables/core/_file-paths.scss b/scss/variables/core/_file-paths.scss
index c2fa73afc..11c2634dc 100644
--- a/scss/variables/core/_file-paths.scss
+++ b/scss/variables/core/_file-paths.scss
@@ -3,13 +3,7 @@
//
// File Paths
//
-// Every variable is declared as !default so that it can be
-// overridden by a previous import.
-//
-// If you want to override a variable, set that variable in one of your
-// own partials, then @import '{path/to/}core/variables'.
-//
-// Styleguide: Variables.Paths
+// Style guide: Variables.Core.Paths
//
//
@@ -19,9 +13,9 @@
//
// Markup: $font-path: '../fonts' !default;
//
-// Styleguide: Variables.Paths.font
+// Styleguide: Variables.Core.Paths.font
//
-$font-path: '../fonts' !default;
+$font-path: '../fonts' !default;
//
// $image-path
@@ -30,6 +24,6 @@ $font-path: '../fonts' !default;
//
// Markup: $image-path: '../img' !default;
//
-// Styleguide: Variables.Paths.image
+// Styleguide: Variables.Core.Paths.image
//
-$image-path: '../img' !default;
+$image-path: '../img' !default;
diff --git a/scss/variables/core/_magic-numbers.scss b/scss/variables/core/_magic-numbers.scss
index 7c614a88e..46060596f 100644
--- a/scss/variables/core/_magic-numbers.scss
+++ b/scss/variables/core/_magic-numbers.scss
@@ -3,145 +3,128 @@
//
// Magic Numbers
//
-// Every variable is declared as !default so that it can be
-// overridden by a previous import.
+// Unique and resuable values with multiple occurrences.
//
-// If you want to override a variable, set that variable in one of your
-// own partials, then @import '{path/to/}core/variables'.
+// Style guide: Variables.Core.Magic
//
-// Styleguide: Variables.Magic
-//
-
//
// $text-max-width
//
-// TODO: Joe to document.
+// For setting a max-width to a portion of text.
//
-// Markup: $text-max-width: 70rem !default;
+// Markup: $text-max-width: 70rem !default;
//
-// Styleguide: Variables.Magic.text-max-width
+// Styleguide: Variables.Core.Magic.text-max-width
//
-$text-max-width: 70rem !default;
+$text-max-width: 70rem !default;
//
// $lead-max-width
//
-// TODO: Joe to document.
+// For setting the max-width for the lead font style.
//
-// Markup: $lead-max-width: 85rem !default;
+// Markup: $lead-max-width: 85rem !default;
//
-// Styleguide: Variables.Magic.lead-max-width
+// Styleguide: Variables.Core.Magic.lead-max-width
//
-$lead-max-width: 85rem !default;
+$lead-max-width: 85rem !default;
//
// $site-max-width
//
-// TODO: Joe to document.
+// For setting the max-width of the project's grid system.
//
-// Markup: $site-max-width: 1220px !default;
+// Markup: $site-max-width: 1220px !default;
//
-// Styleguide: Variables.Magic.site-max-width
+// Styleguide: Variables.Core.Magic.site-max-width
//
-$site-max-width: 1220px !default;
+$site-max-width: 1220px !default;
//
// $site-margins
//
-// TODO: Joe to document.
+// For setting the margins of the project's grid system.
//
-// Markup: $site-margins: 3rem !default;
+// Markup: $site-margins: 3rem !default;
//
-// Styleguide: Variables.Magic.site-margins
+// Styleguide: Variables.Core.Magic.site-margins
//
$site-margins: 3rem !default;
//
// $site-margins-mobile
//
-// TODO: Joe to document.
+// For setting the margins of the project's grid system in mobile.
//
// Markup: $site-margins-mobile: 1.5rem !default;
//
-// Styleguide: Variables.Magic.site-margins-mobile
+// Styleguide: Variables.Core.Magic.site-margins-mobile
//
$site-margins-mobile: 1.5rem !default;
-//
-// $article-max-width
-//
-// TODO: Joe to document.
-//
-// Markup: $article-max-width: 600px !default;
-//
-// Styleguide: Variables.Magic.article-max-width
-//
-$article-max-width: 600px !default;
-
//
// $input-max-width
//
-// TODO: Joe to document.
+// For setting the max-width of input fields.
//
-// Markup: $input-max-width: 46rem !default;
+// Markup: $input-max-width: 46rem !default;
//
-// Styleguide: Variables.Magic.input-max-width
+// Styleguide: Variables.Core.Magic.input-max-width
//
-$input-max-width: 46rem !default;
+$input-max-width: 46rem !default;
//
// $border-radius
//
-// TODO: Joe to document.
+// For setting the default border-radius.
//
-// Markup: $border-radius: 3px !default;
+// Markup: $border-radius: 3px !default;
//
-// Styleguide: Variables.Magic.border-radius
+// Styleguide: Variables.Core.Magic.border-radius
//
-$border-radius: 3px !default;
+$border-radius: 3px !default;
//
// $box-shadow
//
-// TODO: Joe to document.
+// For settings the default box-shadow.
//
-// Markup: $box-shadow: 0 2px 2px 0 rgba(0,0,0,0.2) !default;
+// Markup: $box-shadow: 0 2px 2px 0 rgba(0,0,0,0.2) !default;
//
-// Styleguide: Variables.Magic.box-shadow
+// Styleguide: Variables.Core.Magic.box-shadow
//
-$box-shadow: 0 2px 2px 0 rgba(0,0,0,0.2) !default;
+$box-shadow: 0 2px 2px 0 rgba(0,0,0,0.2) !default;
//
// $focus-shadow
//
-// TODO: Joe to document.
+// For settings the default focus to be applied to items in their focus state.
//
-// Markup: $focus-shadow: 0 0 3px $color-cool-grey, 0 0 7px $color-cool-grey !default;
+// Markup: $focus-shadow: 0 0 3px $color-cool-grey, 0 0 7px $color-cool-grey !default;
//
-// Styleguide: Variables.Magic.focus-shadow
+// Styleguide: Variables.Core.Magic.focus-shadow
//
-$focus-shadow: 0 0 3px $color-cool-grey, 0 0 7px $color-cool-grey !default;
+$focus-shadow: 0 0 3px $color-cool-grey, 0 0 7px $color-cool-grey !default;
//
// $nav-width
//
-// TODO: Joe to document.
+// For setting the width of the navigation.
//
-// Markup: $nav-width: 951px !default;
+// Markup: $nav-width: 951px !default;
//
-// Styleguide: Variables.Magic.nav-width
+// Styleguide: Variables.Core.Magic.nav-width
//
-$nav-width: 951px !default;
+$nav-width: 951px !default;
//
// $hit-area
//
-// 44 x 44 pixels hit target following Apple iOS Human Interface
-// Guidelines.
+// 44 x 44 pixels hit target following Apple iOS Human Interface Guidelines.
//
// Markup: $hit-area: 4.4rem !default;
//
-// Styleguide: Variables.Magic.hit-area
+// Styleguide: Variables.Core.Magic.hit-area
//
$hit-area: 4.4rem !default;
diff --git a/scss/variables/core/_typography.scss b/scss/variables/core/_typography.scss
index ee04a947a..d4b731c57 100644
--- a/scss/variables/core/_typography.scss
+++ b/scss/variables/core/_typography.scss
@@ -3,139 +3,131 @@
//
// Typography
//
-// Every variable is declared as !default so that it can be
-// overridden by a previous import.
+// Style guide: Variables.Core.Typography
//
-// If you want to override a variable, set that variable in one of your
-// own partials, then @import '{path/to/}core/variables'.
-//
-// Removing the !default from $em-base so we are not inheriting that
-// value from Bourbon.
-//
-// Styleguide: Variables.Typography
-//
-
//
// $em-base
//
// Font size.
+// Removing the !default from $em-base so we are not inheriting that
+// value from Bourbon.
//
-// Markup: $em-base: 10px;
+// Markup: $em-base: 10px;
//
-// Styleguide: Variables.Typography.em-base
+// Style guide: Variables.Core.Typography.em-base
//
-$em-base: 10px;
+$em-base: 10px;
//
// $base-font-size
//
// Font size.
//
-// Markup: $base-font-size: 2rem !default;
+// Markup: $base-font-size: 2rem !default;
//
-// Styleguide: Variables.Typography.base-font-size
+// Style guide: Variables.Core.Typography.base-font-size
//
-$base-font-size: 2rem !default;
+$base-font-size: 2rem !default;
//
// $small-font-size
//
// Font size.
//
-// Markup: $small-font-size: 1.7rem !default;
+// Markup: $small-font-size: 1.7rem !default;
//
-// Styleguide: Variables.Typography.small-font-size
+// Style guide: Variables.Core.Typography.small-font-size
//
-$small-font-size: 1.7rem !default;
+$small-font-size: 1.7rem !default;
//
// $lead-font-size
//
// Font size.
//
-// Markup: $lead-font-size: 2.3rem !default;
+// Markup: $lead-font-size: 2.3rem !default;
//
-// Styleguide: Variables.Typography.lead-font-size
+// Style guide: Variables.Core.Typography.lead-font-size
//
-$lead-font-size: 2.3rem !default;
+$lead-font-size: 2.3rem !default;
//
-// $title-font-size
+// $splash-font-size
//
// Font size.
//
-// Markup: $title-font-size: 5.5rem !default;
+// Markup: $splash-font-size: 5.5rem !default;
//
-// Styleguide: Variables.Typography.title-font-size
+// Style guide: Variables.Core.Typography.splash-font-size
//
-$title-font-size: 5.5rem !default;
+$splash-font-size: 5.5rem !default;
//
// $h1-font-size
//
// Font size.
//
-// Markup: $h1-font-size: 4.3rem !default;
+// Markup: $h1-font-size: 4.3rem !default;
//
-// Styleguide: Variables.Typography.h1-font-size
+// Style guide: Variables.Core.Typography.h1-font-size
//
-$h1-font-size: 4.3rem !default;
+$h1-font-size: 4.3rem !default;
//
// $h2-font-size
//
// Font size.
//
-// Markup: $h2-font-size: 3.3rem !default;
+// Markup: $h2-font-size: 3.3rem !default;
//
-// Styleguide: Variables.Typography.h2-font-size
+// Style guide: Variables.Core.Typography.h2-font-size
//
-$h2-font-size: 3.3rem !default;
+$h2-font-size: 3.3rem !default;
//
// $h3-font-size
//
// Font size.
//
-// Markup: $h3-font-size: 2.3rem !default;
+// Markup: $h3-font-size: 2.3rem !default;
//
-// Styleguide: Variables.Typography.h3-font-size
+// Style guide: Variables.Core.Typography.h3-font-size
//
-$h3-font-size: 2.3rem !default;
+$h3-font-size: 2.3rem !default;
//
// $h4-font-size
//
// Font size.
//
-// Markup: $h4-font-size: 2rem !default;
+// Markup: $h4-font-size: 2rem !default;
//
-// Styleguide: Variables.Typography.h4-font-size
+// Style guide: Variables.Core.Typography.h4-font-size
//
-$h4-font-size: 2rem !default;
+$h4-font-size: 2rem !default;
//
// $h5-font-size
//
// Font size.
//
-// Markup: $h5-font-size: 1.8rem !default;
+// Markup: $h5-font-size: 1.8rem !default;
//
-// Styleguide: Variables.Typography.h5-font-size
+// Style guide: Variables.Core.Typography.h5-font-size
//
-$h5-font-size: 1.8rem !default;
+$h5-font-size: 1.8rem !default;
//
// $h6-font-size
//
// Font size.
//
-// Markup: $h6-font-size: 1.6rem !default;
+// Markup: $h6-font-size: 1.6rem !default;
//
-// Styleguide: Variables.Typography.h6-font-size
+// Style guide: Variables.Core.Typography.h6-font-size
//
-$h6-font-size: 1.6rem !default;
+$h6-font-size: 1.6rem !default;
//
@@ -143,11 +135,11 @@ $h6-font-size: 1.6rem !default;
//
// Default line height.
//
-// Markup: $base-line-height: 1.4 !default;
+// Markup: $base-line-height: 1.4 !default;
//
-// Styleguide: Variables.Typography.base-line-height
+// Style guide: Variables.Core.Typography.base-line-height
//
-$base-line-height: 1.4 !default;
+$base-line-height: 1.4 !default;
//
// $heading-line-height
@@ -156,7 +148,7 @@ $base-line-height: 1.4 !default;
//
// Markup: $heading-line-height: 1.2 !default;
//
-// Styleguide: Variables.Typography.heading-line-height
+// Style guide: Variables.Core.Typography.heading-line-height
//
$heading-line-height: 1.2 !default;
@@ -165,11 +157,11 @@ $heading-line-height: 1.2 !default;
//
// Default line height.
//
-// Markup: $lead-line-height: 1.5 !default;
+// Markup: $lead-line-height: 1.5 !default;
//
-// Styleguide: Variables.Typography.lead-line-height
+// Style guide: Variables.Core.Typography.lead-line-height
//
-$lead-line-height: 1.5 !default;
+$lead-line-height: 1.5 !default;
//
@@ -177,33 +169,33 @@ $lead-line-height: 1.5 !default;
//
// font-sans Font family.
//
-// Markup: $font-sans: 'Source Sans Pro', $helvetica !default;
+// Markup: $font-sans: 'Source Sans Pro', $helvetica !default;
//
-// Styleguide: Variables.Typography.font-sans
+// Style guide: Variables.Core.Typography.font-sans
//
-$font-sans: 'Source Sans Pro', $helvetica !default;
+$font-sans: 'Source Sans Pro', $helvetica !default;
//
// $font-serif
//
// font-serif Font family.
//
-// Markup: $font-serif: 'Crimson Text', $georgia !default;
+// Markup: $font-serif: 'Crimson Text', $georgia !default;
//
-// Styleguide: Variables.Typography.font-serif
+// Style guide: Variables.Core.Typography.font-serif
//
-$font-serif: 'Crimson Text', $georgia !default;
+$font-serif: 'Crimson Text', $georgia !default;
//
// $font-slab
//
// font-slab Font family.
//
-// Markup: $font-slab: 'Roboto Slab', $georgia !default;
+// Markup: $font-slab: 'Roboto Slab', $georgia !default;
//
-// Styleguide: Variables.Typography.font-slab
+// Style guide: Variables.Core.Typography.font-slab
//
-$font-slab: 'Roboto Slab', $georgia !default;
+$font-slab: 'Roboto Slab', $georgia !default;
//
@@ -211,52 +203,52 @@ $font-slab: 'Roboto Slab', $georgia !default;
//
// font-x-light Font weight.
//
-// Markup: $font-x-light: 100 !default;
+// Markup: $font-x-light: 100 !default;
//
-// Styleguide: Variables.Typography.font-x-light
+// Style guide: Variables.Core.Typography.font-x-light
//
-$font-x-light: 100 !default;
+$font-x-light: 100 !default;
//
// $font-light
//
// font-light Font weight.
//
-// Markup: $font-light: 200 !default;
+// Markup: $font-light: 200 !default;
//
-// Styleguide: Variables.Typography.font-light
+// Style guide: Variables.Core.Typography.font-light
//
-$font-light: 200 !default;
+$font-light: 200 !default;
//
// $font-normal
//
// font-normal Font weight.
//
-// Markup: $font-normal: 400 !default;
+// Markup: $font-normal: 400 !default;
//
-// Styleguide: Variables.Typography.font-normal
+// Style guide: Variables.Core.Typography.font-normal
//
-$font-normal: 400 !default;
+$font-normal: 400 !default;
//
// $font-bold
//
// font-bold Font weight.
//
-// Markup: $font-bold: 600 !default;
+// Markup: $font-bold: 600 !default;
//
-// Styleguide: Variables.Typography.font-bold
+// Style guide: Variables.Core.Typography.font-bold
//
-$font-bold: 600 !default;
+$font-bold: 600 !default;
//
// $font-x-bold
//
// font-x-bold Font weight.
//
-// Markup: $font-x-bold: 700 !default;
+// Markup: $font-x-bold: 700 !default;
//
-// Styleguide: Variables.Typography.font-x-bold
+// Style guide: Variables.Core.Typography.font-x-bold
//
-$font-x-bold: 700 !default;
+$font-x-bold: 700 !default;
diff --git a/scss/variables/core/index.scss b/scss/variables/core/index.scss
index 8d3ffd60b..d9a155d08 100644
--- a/scss/variables/core/index.scss
+++ b/scss/variables/core/index.scss
@@ -1,8 +1,12 @@
@charset "UTF-8";
-///
-/// ROLL UP
-///
+//
+// Core
+//
+// Variables for core settings.
+//
+// Style guide: Variables.Core
+//
@import
'asset-pipeline',
diff --git a/scss/variables/elements/_buttons.scss b/scss/variables/elements/_buttons.scss
index 6ec76f735..bc3592fda 100644
--- a/scss/variables/elements/_buttons.scss
+++ b/scss/variables/elements/_buttons.scss
@@ -3,15 +3,8 @@
//
// Buttons
//
-// Every variable is declared as !default so that it can be
-// overridden by a previous import.
+// Style guide: Variables.Elements.Buttons
//
-// If you want to override a variable, set that variable in one of your
-// own partials, then @import '{path/to/}core/variables'.
-//
-// Styleguide: Variables.Buttons
-//
-
//
// $button-stroke
@@ -20,6 +13,6 @@
//
// Markup: $button-stroke: inset 0 0 0 2px !default;
//
-// Styleguide: Variables.Buttons.Stroke
+// Styleguide: Variables.Elements.Buttons.Stroke
//
$button-stroke: inset 0 0 0 2px !default;
diff --git a/scss/variables/elements/_embed.scss b/scss/variables/elements/_embed.scss
index 6ca3806bb..017d876e6 100644
--- a/scss/variables/elements/_embed.scss
+++ b/scss/variables/elements/_embed.scss
@@ -3,34 +3,27 @@
//
// Embed
//
-// Every variable is declared as !default so that it can be
-// overridden by a previous import.
+// Style guide: Variables.Elements.Embed
//
-// If you want to override a variable, set that variable in one of your
-// own partials, then @import '{path/to/}core/variables'.
-//
-// Styleguide: Variables.Embed
-//
-
//
// $aspect-height
//
-// Default Aspect Height Setting.
+// Default aspect height setting.
//
// Markup: $aspect-height: 9;
//
-// Styleguide: Variables.Embed.Aspect-Height
+// Styleguide: Variables.Elements.Embed.Aspect-Height
//
$aspect-height: 9 !default;
//
// $aspect-width
//
-// Default Aspect Width Setting.
+// Default aspect width setting.
//
// Markup: $aspect-width: 16;
//
-// Styleguide: Variables.Embed.Aspect-Width
+// Styleguide: Variables.Elements.Embed.Aspect-Width
//
$aspect-width: 16 !default;
diff --git a/scss/variables/elements/_inputs.scss b/scss/variables/elements/_inputs.scss
index 425a7c114..5ad4988fe 100644
--- a/scss/variables/elements/_inputs.scss
+++ b/scss/variables/elements/_inputs.scss
@@ -3,13 +3,7 @@
//
// Inputs
//
-// Every variable is declared as !default so that it can be
-// overridden by a previous import.
-//
-// If you want to override a variable, set that variable in one of your
-// own partials, then @import '{path/to/}core/variables'.
-//
-// Styleguide: Variables.Inputs
+// Style guide: Variables.Elements.Inputs
//
//
@@ -19,9 +13,9 @@
//
// Markup: $input-line-height: 1.3;
//
-// Styleguide: Variables.Inputs.line-height
+// Styleguide: Variables.Elements.Inputs.line-height
//
-$input-line-height: 1.3;
+$input-line-height: 1.3;
//
// $input-border-width
@@ -30,7 +24,7 @@ $input-line-height: 1.3;
//
// Markup: $input-border-width: 0.1rem;
//
-// Styleguide: Variables.Inputs.border-width
+// Styleguide: Variables.Elements.Inputs.border-width
//
$input-border-width: 0.1rem;
@@ -42,7 +36,7 @@ $input-border-width: 0.1rem;
//
// Markup: $input-padding-vertical: 1rem;
//
-// Styleguide: Variables.Inputs.padding-vertical
+// Styleguide: Variables.Elements.Inputs.padding-vertical
//
$input-padding-vertical: 1rem;
@@ -54,7 +48,7 @@ $input-padding-vertical: 1rem;
//
// Markup: $input-height-exact: $base-font-size * $input-line-height + $input-padding-vertical * 2 + $input-border-width * 2;
//
-// Styleguide: Variables.Inputs.height-exact
+// Styleguide: Variables.Elements.Inputs.height-exact
//
$input-height-exact: $base-font-size * $input-line-height + $input-padding-vertical * 2 + $input-border-width * 2;
@@ -66,6 +60,6 @@ $input-height-exact: $base-font-size * $input-line-height + $input-padding-verti
//
// Markup: $input-height: floor($input-height-exact * 10) / 10;
//
-// Styleguide: Variables.Inputs.input-height
+// Styleguide: Variables.Elements.Inputs.input-height
//
$input-height: floor($input-height-exact * 10) / 10;
diff --git a/scss/variables/elements/index.scss b/scss/variables/elements/index.scss
index ec0aea885..db50024cc 100644
--- a/scss/variables/elements/index.scss
+++ b/scss/variables/elements/index.scss
@@ -1,8 +1,12 @@
@charset "UTF-8";
-///
-/// ROLL UP
-///
+//
+// Elements
+//
+// Variables for core elements.
+//
+// Style guide: Variables.Elements
+//
@import
'buttons',
diff --git a/scss/variables/index.scss b/scss/variables/index.scss
index af379e958..1a4382e13 100644
--- a/scss/variables/index.scss
+++ b/scss/variables/index.scss
@@ -3,6 +3,14 @@
//
// Variables
//
+// Variables are a way to store information that will be reused throughout a
+// project. They store things like colors and fonts, or any CSS value that'll be
+// reused.
+// Every variable is declared as !default so that it can be
+// overridden by a previous import.
+// If you want to override a variable, set that variable in one of your
+// own partials, then @import '{path/to/}core/variables'.
+//
// Style guide: Variables
// Load order convention exception
diff --git a/scss/variables/pre-vendor/index.scss b/scss/variables/pre-vendor/index.scss
index e37d4cbd8..5aa6ff8a7 100644
--- a/scss/variables/pre-vendor/index.scss
+++ b/scss/variables/pre-vendor/index.scss
@@ -1,8 +1,12 @@
@charset "UTF-8";
-///
-/// ROLL UP
-///
+//
+// Pre Vendor
+//
+// Variables that need to be set before including vendor files.
+//
+// Style guide: Variables.Vendor
+//
// Any settings that need to be defined BEFORE including
// vendor dependencies.
diff --git a/styleguide/index.html b/styleguide/index.html
index ee1596c51..2f49e8abb 100644
--- a/styleguide/index.html
+++ b/styleguide/index.html
@@ -27,33 +27,48 @@
An expandable menu in which choices are displayed in a two-dimensional
+dropdown layout. Excellent design choice for accommodating a large number of
+options or for revealing lower-level site pages at a glance.
Source Sans Pro is an open-source sans serif typeface created for legibility in UI design. With a variety of weights that read easily at all sizes, Source Sans Pro provides clear headers as well as highly-readable body text.
+
Heading 1
+
Heading 2
+
Heading 3
+
Heading 4
+
Heading 5
+
Heading 6
+
Paragraph text lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
+
+
+
+
Crimson Text
+
Crimson Text ("Crimson") is a free and open-source text type family. The font is designed in the tradition of beautiful oldstyle type. It features six cuts characters for a wide range of European languages.
+
Heading1
+
Heading 2
+
Heading 3
+
Heading 4
+
Heading 5
+
Heading 6
+
Paragraph text lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
+
+
+
+
Roboto Slab
+
Roboto has a dual nature. It has a mechanical skeleton and the forms are largely geometric. At the same time, the font features friendly and open curves. While some grotesks distort their letterforms to force a rigid rhythm, Roboto doesn’t compromise,
+ allowing letters to be settled into their natural width. This makes for a more natural reading rhythm more commonly found in humanist and serif types.
+
Heading 1
+
Heading 2
+
Heading 3
+
Heading 4
+
Heading 5
+
Heading 6
+
Paragraph text lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
<div class="decanter-sans">
+ <h2>Source Sans Pro</h2>
+ <p class="decanter-font-lead">Source Sans Pro is an open-source sans serif typeface created for legibility in UI design. With a variety of weights that read easily at all sizes, Source Sans Pro provides clear headers as well as highly-readable body text.</p>
+ <h1>Heading 1</h1>
+ <h2>Heading 2</h2>
+ <h3>Heading 3</h3>
+ <h4>Heading 4</h4>
+ <h5>Heading 5</h5>
+ <h6>Heading 6</h6>
+ <p>Paragraph text lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.</p>
+ </div>
+
+ <div class="decanter-serif">
+ <h2>Crimson Text</h2>
+ <p class="decanter-font-lead">Crimson Text ("Crimson") is a free and open-source text type family. The font is designed in the tradition of beautiful oldstyle type. It features six cuts characters for a wide range of European languages.</p>
+ <h1>Heading1</h1>
+ <h2>Heading 2</h2>
+ <h3>Heading 3</h3>
+ <h4>Heading 4</h4>
+ <h5>Heading 5</h5>
+ <h6>Heading 6</h6>
+ <p>Paragraph text lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.</p>
+ </div>
+
+ <div class="decanter-slab">
+ <h2>Roboto Slab</h2>
+ <p class="decanter-font-lead">Roboto has a dual nature. It has a mechanical skeleton and the forms are largely geometric. At the same time, the font features friendly and open curves. While some grotesks distort their letterforms to force a rigid rhythm, Roboto doesn’t compromise,
+ allowing letters to be settled into their natural width. This makes for a more natural reading rhythm more commonly found in humanist and serif types.</p>
+ <h1>Heading 1</h1>
+ <h2>Heading 2</h2>
+ <h3>Heading 3</h3>
+ <h4>Heading 4</h4>
+ <h5>Heading 5</h5>
+ <h6>Heading 6</h6>
+ <p>Paragraph text lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.</p>
+ </div>
+
Default styling for tables. For displaying tabular data that best lends
+itself to being layed out in columns and rows.
+Modifier class available to remove tables borders.
Default typography styling for base HTML typography elements, including
+paragraphs and headings. Also includes special type treatment classes such as
+splash font and lead font.
+
+
+
+
+
+
+
+ Examples
+
+
+ Default styling
+
+
+
+
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
+
+
+
+
+
+ .decanter-font-lead
+
+
+ Lead Font
+
+
+
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
+
+
+
+
+ .decanter-font-splash
+
+
+ Splash Font
+
+
+
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
+
+
+
+
+ .decanter-short-line-length
+
+
+ Short Line Length
+
+
+
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
+
+
+
+
+ .decanter-caption
+
+
+ Caption Font
+
+
+
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
+
+
+
+
+ .decanter-credits
+
+
+ Credits Font
+
+
+
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
<p class="[modifier class]">Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.</p>
+
An expandable menu in which choices are displayed in a two-dimensional
+dropdown layout. Excellent design choice for accommodating a large number of
+options or for revealing lower-level site pages at a glance.
+
+
+
+
+
+
+
+ Source: utilities/mixins/menus/_megamenu.scss, line 3
+
Merges $decanter-alerts and $decanter-custom-alerts maps into a new, single
+map.
+Keys in $decanter-custom-alerts will take precedence over keys in
+$decanter-alerts. This is the best way to add new values to a map.
Default color palette. Primary colors include Cardinal Red, White, Cool Grey,
+and Black. All other colors are supporting colors.
+See complete color palette at
+http://identity.stanford.edu/color.html#digital-color.