uswds · thisisdano · May 19, 2021 · Apr 19, 2021 · Apr 19, 2021 · Apr 19, 2021
diff --git a/.circleci/config.yml b/.circleci/config.yml
@@ -11,34 +11,34 @@ jobs:
       - checkout
       - restore_cache:
           keys:
-            - v1-gem-cache-{{ checksum "Gemfile.lock" }}
-            - v1-gem-cache
+            - npm-cache-{{ checksum "package-lock.json" }}
+      - restore_cache:
+          keys:
+            - gem-cache-{{ checksum "Gemfile.lock" }}
+            - gem-cache
       - run:
           name: Install ruby dependencies
           command: |
             gem update --system
             gem install bundler
             bundle install --jobs=4 --retry=3 --path vendor/bundle
+      - run:
+          name: Install scss_lint
+          command: gem install scss_lint
       - save_cache:
-          key: v1-gem-cache-{{ checksum "Gemfile.lock" }}
+          key: gem-cache-{{ checksum "Gemfile.lock" }}
           paths:
             - vendor/bundle
-      - restore_cache:
-          keys:
-            - v2-npm-cache-{{ .Branch }}-{{ .Revision }}
       - run:
           name: Install node dependencies
           command: npm install
+      - run:
+          name: Build USWDS if needed
+          command: npm run build-uswds
       - save_cache:
-          key: v2-npm-cache-{{ .Branch }}-{{ .Revision }}
+          key: npm-cache-{{ checksum "package-lock.json" }}
           paths:
             - node_modules
-      - run:
-          name: Build site files
-          command: npm run build
-      - run:
-          name: Install scss_lint
-          command: gem install scss_lint
       - snyk/scan:
           organization: uswds
       - run:

diff --git a/.gitignore b/.gitignore
@@ -11,3 +11,4 @@ assets/
 contrast-report.json
 .jekyll-cache/
 vendor/
+pa11y-results.json
diff --git a/.pa11yci b/.pa11yci
@@ -0,0 +1,9 @@
+{
+  "defaults": {
+    "userAgent": "pa11y",
+    "timeout": 120000,
+    "concurrency": 8,
+    "standard": "WCAG2AA",
+    "runners": ["axe"]
+  }
+}
diff --git a/.pa11yci--mobile b/.pa11yci--mobile
@@ -0,0 +1,13 @@
+{
+  "defaults": {
+    "userAgent": "pa11y",
+    "timeout": 120000,
+    "concurrency": 8,
+    "standard": "WCAG2AA",
+    "runners": ["axe"],
+    "viewport": {
+        "width": 375,
+        "height": 667
+    }
+  }
+}
diff --git a/.snyk b/.snyk
@@ -184,6 +184,9 @@ ignore:
     - gulp-sass > node-sass:
         reason: No available upgrade or patch.
         expires: '2021-05-14T18:28:34.968Z'
+    - gulp-sass > node-sass:
+        reason: No available upgrade or patch.
+        expires: '2021-06-16T00:00:27.921Z'
   SNYK-JS-NODESASS-535502:
     - uswds > gulp-sass > node-sass:
         reason: None given
@@ -212,6 +215,9 @@ ignore:
     - gulp-sass > node-sass:
         reason: No available upgrade or patch.
         expires: '2021-05-14T18:28:34.968Z'
+    - gulp-sass > node-sass:
+        reason: No available upgrade or patch.
+        expires: '2021-06-16T00:00:27.921Z'
   SNYK-JS-NODESASS-540956:
     - uswds > gulp-sass > node-sass:
         reason: None given
@@ -240,6 +246,9 @@ ignore:
     - gulp-sass > node-sass:
         reason: No available upgrade or patch.
         expires: '2021-05-14T18:28:34.968Z'
+    - gulp-sass > node-sass:
+        reason: No available upgrade or patch.
+        expires: '2021-06-16T00:00:27.921Z'
   SNYK-JS-NODESASS-540958:
     - uswds > gulp-sass > node-sass:
         reason: None given
@@ -268,6 +277,9 @@ ignore:
     - gulp-sass > node-sass:
         reason: No available upgrade or patch.
         expires: '2021-05-14T18:28:34.968Z'
+    - gulp-sass > node-sass:
+        reason: No available upgrade or patch.
+        expires: '2021-06-16T00:00:27.921Z'
   SNYK-JS-NODESASS-540964:
     - uswds > gulp-sass > node-sass:
         reason: None given
@@ -296,6 +308,9 @@ ignore:
     - gulp-sass > node-sass:
         reason: No available upgrade or patch.
         expires: '2021-05-14T18:28:34.968Z'
+    - gulp-sass > node-sass:
+        reason: No available upgrade or patch.
+        expires: '2021-06-16T00:00:27.921Z'
   SNYK-JS-NODESASS-540974:
     - uswds > gulp-sass > node-sass:
         reason: Wait for USWDS 2.6.0
@@ -343,6 +358,9 @@ ignore:
     - gulp-sass > node-sass:
         reason: No patch available
         expires: '2021-05-14T18:28:34.968Z'
+    - gulp-sass > node-sass:
+        reason: No patch available
+        expires: '2021-06-16T00:00:27.921Z'
   SNYK-JS-NODESASS-540980:
     - uswds > gulp-sass > node-sass:
         reason: None given
@@ -371,6 +389,9 @@ ignore:
     - gulp-sass > node-sass:
         reason: No patch available
         expires: '2021-05-14T18:28:34.968Z'
+    - gulp-sass > node-sass:
+        reason: No patch available
+        expires: '2021-06-16T00:00:27.921Z'
   SNYK-JS-NODESASS-540990:
     - uswds > gulp-sass > node-sass:
         reason: None given
@@ -399,6 +420,9 @@ ignore:
     - gulp-sass > node-sass:
         reason: No patch available
         expires: '2021-05-14T18:28:34.968Z'
+    - gulp-sass > node-sass:
+        reason: No patch available
+        expires: '2021-06-16T00:00:27.921Z'
   SNYK-JS-NODESASS-540992:
     - uswds > gulp-sass > node-sass:
         reason: None given
@@ -427,6 +451,9 @@ ignore:
     - gulp-sass > node-sass:
         reason: No patch available
         expires: '2021-05-14T18:28:34.968Z'
+    - gulp-sass > node-sass:
+        reason: No patch available
+        expires: '2021-06-16T00:00:27.921Z'
   SNYK-JS-NODESASS-540994:
     - uswds > gulp-sass > node-sass:
         reason: None given
@@ -455,6 +482,9 @@ ignore:
     - gulp-sass > node-sass:
         reason: No patch available
         expires: '2021-05-14T18:28:34.968Z'
+    - gulp-sass > node-sass:
+        reason: No patch available
+        expires: '2021-06-16T00:00:27.921Z'
   SNYK-JS-NODESASS-540996:
     - uswds > gulp-sass > node-sass:
         reason: None given
@@ -483,6 +513,9 @@ ignore:
     - gulp-sass > node-sass:
         reason: No patch available
         expires: '2021-05-14T18:28:34.968Z'
+    - gulp-sass > node-sass:
+        reason: No patch available
+        expires: '2021-06-16T00:00:27.921Z'
   SNYK-JS-NODESASS-540998:
     - uswds > gulp-sass > node-sass:
         reason: None given
@@ -511,6 +544,9 @@ ignore:
     - gulp-sass > node-sass:
         reason: No patch available
         expires: '2021-05-14T18:28:34.968Z'
+    - gulp-sass > node-sass:
+        reason: No patch available
+        expires: '2021-06-16T00:00:27.921Z'
   SNYK-JS-NODESASS-541000:
     - uswds > gulp-sass > node-sass:
         reason: None given
@@ -1088,7 +1124,7 @@ ignore:
   SNYK-JS-NODESASS-1059081:
     - gulp-sass > node-sass:
         reason: No available upgrade or patch.
-        expires: '2021-05-14T18:28:34.968Z'
+        expires: '2021-06-16T00:00:27.921Z'
     - uswds > gulp-sass > node-sass:
         reason: None given
         expires: '2021-03-21T22:33:04.905Z'
@@ -1101,7 +1137,7 @@ ignore:
   SNYK-JS-NODESASS-535500:
     - gulp-sass > node-sass:
         reason: No available upgrade or patch.
-        expires: '2021-05-14T18:28:34.968Z'
+        expires: '2021-06-16T00:00:27.921Z'
     - uswds > gulp-sass > node-sass:
         reason: None given
         expires: '2021-03-21T22:33:04.905Z'
@@ -1686,7 +1722,7 @@ ignore:
   SNYK-JS-POSTCSS-1090595:
     - gulp-sourcemaps > @gulp-sourcemaps/identity-map > postcss:
         reason: None given
-        expires: '2021-05-14T18:28:34.968Z'
+        expires: '2021-06-16T00:00:27.921Z'
     - uswds > postcss-discard-comments > postcss:
         reason: None given
         expires: '2021-05-28T18:17:23.014Z'

diff --git a/Gemfile b/Gemfile
@@ -3,10 +3,11 @@ source 'https://rubygems.org'
 gem "jekyll", '>= 4.2.0'
 gem 'json', '>= 2.3.0'
 gem 'jekyll-redirect-from', '>= 0.15.0'
-gem 'jekyll-sitemap', '>= 1.3.1'
+gem 'jekyll-sitemap', '>= 1.4.0'
 gem 'scss_lint'
 gem 'jekyll-include-cache'
 gem 'liquid-c'
+gem 'html-proofer'
 
 gem 'rspec-core'
 gem 'rspec-expectations'
diff --git a/Gemfile.lock b/Gemfile.lock
@@ -9,9 +9,19 @@ GEM
     em-websocket (0.5.2)
       eventmachine (>= 0.12.9)
       http_parser.rb (~> 0.6.0)
+    ethon (0.12.0)
+      ffi (>= 1.3.0)
     eventmachine (1.2.7)
     ffi (1.13.1)
     forwardable-extended (2.6.0)
+    html-proofer (3.19.1)
+      addressable (~> 2.3)
+      mercenary (~> 0.3)
+      nokogumbo (~> 2.0)
+      parallel (~> 1.3)
+      rainbow (~> 3.0)
+      typhoeus (~> 1.3)
+      yell (~> 2.0)
     http_parser.rb (0.6.0)
     i18n (1.8.5)
       concurrent-ruby (~> 1.0)
@@ -52,9 +62,20 @@ GEM
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
     mercenary (0.4.0)
+    mini_portile2 (2.5.1)
+    nokogiri (1.11.3)
+      mini_portile2 (~> 2.5.0)
+      racc (~> 1.4)
+    nokogiri (1.11.3-x86_64-darwin)
+      racc (~> 1.4)
+    nokogumbo (2.0.5)
+      nokogiri (~> 1.8, >= 1.8.4)
+    parallel (1.20.1)
     pathutil (0.16.2)
       forwardable-extended (~> 2.6)
     public_suffix (4.0.6)
+    racc (1.5.2)
+    rainbow (3.0.0)
     rb-fsevent (0.10.4)
     rb-inotify (0.10.1)
       ffi (~> 1.0)
@@ -78,22 +99,27 @@ GEM
       sass (~> 3.5, >= 3.5.5)
     terminal-table (2.0.0)
       unicode-display_width (~> 1.1, >= 1.1.1)
+    typhoeus (1.4.0)
+      ethon (>= 0.9.0)
     unicode-display_width (1.7.0)
+    yell (2.2.2)
 
 PLATFORMS
   ruby
   x86_64-darwin-18
+  x86_64-darwin-19
 
 DEPENDENCIES
+  html-proofer
   jekyll (>= 4.2.0)
   jekyll-include-cache
   jekyll-redirect-from (>= 0.15.0)
-  jekyll-sitemap (>= 1.3.1)
+  jekyll-sitemap (>= 1.4.0)
   json (>= 2.3.0)
   liquid-c
   rspec-core
   rspec-expectations
   scss_lint
 
 BUNDLED WITH
-   2.2.1
+   2.2.14
diff --git a/_components/banner/guidance/usability.md b/_components/banner/guidance/usability.md
@@ -1,4 +1,4 @@
-- **Use the provided text without customization.** The banner is most effective as an identifier and a learning tool when its message is consistent across government websites. With only a few exceptions (see [Implementation guidance](#banner-implementation)), sites should use the TLD-appropriate text provided, unaltered. Use the Spanish version of the banner for Spanish-language websites.
+- **Use the provided text without customization.** The banner is most effective as an identifier and a learning tool when its message is consistent across government websites. With only a few exceptions (see [Implementation guidance](#using-the-banner-component)), sites should use the TLD-appropriate text provided, unaltered. Use the Spanish version of the banner for Spanish-language websites.
 - **Use the version appropriate to your website’s TLD.** If your project uses a .mil top-level domain, use the .mil banner text.
 - **Show the banner on every page.** Use the banner at the top of every page of a site. It can be confusing or misleading if it appears on some pages and not others.
 - **Avoid distraction.** The banner appears on every page of your site. Choose background colors that fit with your site theme and avoid color combinations that draw excessive attention to the banner.

diff --git a/_components/button-group/button-group--default.md b/_components/button-group/button-group--default.md
@@ -8,6 +8,7 @@ layout: component
 lead: The default button group arranges each button as a separate element with a gap between them. On mobile devices, the buttons are arranged vertically.
 order: 01
 parent: Button group
+sitemap: false
 title: Default button group
 variants:
   - variant: "`.usa-button-group--segmented`"

diff --git a/_components/button-group/button-group--segmented.md b/_components/button-group/button-group--segmented.md
@@ -10,6 +10,7 @@ lead: Segmented button groups display a set of discrete buttons in a row as a si
 order: 02
 output: false
 parent: Button group
+sitemap: false
 title: Segmented button group
 variants:
   - variant: "`.usa-button-group--segmented`"

diff --git a/_components/collection/guidance/usability.md b/_components/collection/guidance/usability.md
@@ -5,5 +5,5 @@
 - **Link to additional related content, if applicable.** Collections may not include every piece of content related to its theme. If there's a location that collects more comprehensive results related to the theme, add a link to that location.
 - **Provide a button or link to where more articles can be found.** Users may need access to an index or archive where they can find more articles than those listed in the component.
 - **Provide a strong "information scent" for each article.** Use headings, teaser text, a thumbnail image, and meta information effectively to help users understand the value of each item and choose which ones to visit.
-- **Indicate to the user if they'll navigate to another website.** A common way to do this is to add the [external link class]({{ site.baseurl }}/components/typography/#links) to the heading if the link takes you away from the current site.
+- **Indicate to the user if they'll navigate to another website.** A common way to do this is to add the [external link class]({{ site.baseurl }}/components/link) to the heading if the link takes you away from the current site.
 - **Don’t force in-page scrolling.** Display all collection items in a flexible container so it displays without forcing the user to scroll within a component container. You can help prevent this by limiting the number of items in the collection to six or fewer.
diff --git a/_components/date-input/guidance/accessibility.md b/_components/date-input/guidance/accessibility.md
@@ -1,3 +1,3 @@
-- **Follow input guidance.** These text fields should follow the accessibility [guidelines for all text inputs]({{ site.baseurl }}/form-controls/#text-inputs).
+- **Follow input guidance.** These text fields should follow the accessibility [guidelines for all text inputs]({{ site.baseurl }}/components/text-input).
- **Follow input guidance.** These text fields should follow the accessibility [guidelines for all text inputs]({{ site.baseurl }}/components/text-input).
+- **Follow input guidance.** These text fields should follow the accessibility [guidelines for all text inputs]({{ site.baseurl }}/components/text-input/#text-input-guidance).
- **Follow input guidance.** These text fields should follow the accessibility [guidelines for all text inputs]({{ site.baseurl }}/components/text-input).
+- **Follow input guidance.** These text fields should follow the accessibility [guidelines for all text inputs]({{ site.baseurl }}/components/text-input/#text-input-guidance).
 - **Don’t auto-advance focus.** Do not use JavaScript to auto advance the focus from one field to the next. This makes it difficult for keyboard-only users to navigate and correct mistakes.
 - **Use "text" instead of "number" inputs.** Research indicates that [numeric inputs still carry many usability problems](https://technology.blog.gov.uk/2020/02/24/why-the-gov-uk-design-system-team-changed-the-input-type-for-numbers/).
diff --git a/_components/figure/_figure.md b/_components/figure/_figure.md
@@ -0,0 +1,20 @@
+---
+component:
+  status: alpha
+  package: usa-figure
+  dependencies:
+output: false
+layout: styleguide
+title: Figure
+category: Components
+lead: Intro text on what is included in this section and how to use it. No more than one or two sentences.
+subnav:
+- text: Preview
+  href: '#tk-preview'
+- text: Code
+  href: '#tk-code'
+- text: Guidance
+  href: '#tk-guidance'
+- text: Package
+  href: '#tk-package'
+---