govuk_publishing_components 9.5.1 → 9.5.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5554f431d5b1d929b511ee4cb9f2ed30d990062a39861d0556a5212c13a86597
-  data.tar.gz: 243b8ef4f539bb630c088ddd4a55d28588a5fff283bc91258ffc10cffe4d0a1a
+  metadata.gz: 884f2ae7c8ef7dd478e4e41f4259d24dec57cbe60ba5eb7b7d239ea67bcae620
+  data.tar.gz: b59dc153934e9d15920e4782859afde8906d051dc9be4be3301d369419e6ffd9
 SHA512:
-  metadata.gz: 863f52e9ed306056b3f03ced2083aefa5bea0b5ac2e3b4c7c52bba68c3b94c4057ac915f23ddd3034a9ace4cf7daba0396124a1724d34add81f59addf75f1fb1
-  data.tar.gz: 57836f091c4053a419d9a4e5c9ec945f35d71f2f005e62b92b37e8ea8e07e2c426a5b46e12bd9b295590cd0f01d547a32ea940c8807056f885c78c0a64c3e6d8
+  metadata.gz: 537ae66c5a07ecf928779fd759693207a091950e6fa4c7bb36bf1359033dee03a69b6b4740af395f64c0b472b251a83e59ae271b5ab4990b5b0492e479ebabd3
+  data.tar.gz: 2212a7f125b2c851855c4e7e7d3e1755f53f2a70a46ad2fcea136b74378d342a4dfa8c1d5e9d1ca95cb7e04b1ff2dfb4dd507679e052567a33ef445e227d9967

data/app/assets/javascripts/govuk_publishing_components/components/step-by-step-nav.js

@@ -45,8 +45,11 @@
       bindComponentLinkClicks(stepNavTracker);
 
       function getTextForInsertedElements() {
-        actions.showText = $element.attr('data-show-text');
-        actions.hideText = $element.attr('data-hide-text');
+        var openBracket = '<span class="visuallyhidden">(</span>';
+        var closeBracket = '<span class="visuallyhidden">)</span>';
+
+        actions.showText = openBracket + $element.attr('data-show-text') + closeBracket;
+        actions.hideText = openBracket + $element.attr('data-hide-text') + closeBracket;
         actions.showAllText = $element.attr('data-show-all-text');
         actions.hideAllText = $element.attr('data-hide-all-text');
       }
@@ -64,7 +67,9 @@
           }
 
           if (!$(this).find('.js-toggle-link').length) {
-            $(this).find('.js-step-title-button').append('<span class="gem-c-step-nav__toggle-link js-toggle-link" aria-hidden="true">' + linkText + '</span>');
+            $(this).find('.js-step-title-button').append(
+              '<span class="gem-c-step-nav__toggle-link js-toggle-link" aria-hidden="true" hidden></span>'
+            );
           }
         });
       }
@@ -250,7 +255,7 @@
 
           if ($showOrHideAllButton.text() == actions.showAllText) {
             $showOrHideAllButton.text(actions.hideAllText);
-            $element.find('.js-toggle-link').text(actions.hideText);
+            $element.find('.js-toggle-link').html(actions.hideText);
             shouldshowAll = true;
 
             stepNavTracker.track('pageElementInteraction', 'stepNavAllShown', {
@@ -258,7 +263,7 @@
             });
           } else {
             $showOrHideAllButton.text(actions.showAllText);
-            $element.find('.js-toggle-link').text(actions.showText);
+            $element.find('.js-toggle-link').html(actions.showText);
             shouldshowAll = false;
 
             stepNavTracker.track('pageElementInteraction', 'stepNavAllHidden', {
@@ -316,7 +321,7 @@
         $stepElement.toggleClass('step-is-shown', isShown);
         $stepContent.toggleClass('js-hidden', !isShown);
         $titleLink.attr("aria-expanded", isShown);
-        $stepElement.find('.js-toggle-link').text(isShown ? actions.hideText : actions.showText);
+        $stepElement.find('.js-toggle-link').html(isShown ? actions.hideText : actions.showText);
       }
 
       function isShown() {

data/app/assets/javascripts/govuk_publishing_components/vendor/modernizr.js

@@ -0,0 +1,3 @@
+/*! modernizr 3.6.0 (Custom Build) | MIT *
+ * https://modernizr.com/download/?-flexbox-flexboxtweener-history-printshiv-setclasses !*/
+!function(e,t,n){function r(e,t){return typeof e===t}function o(){var e,t,n,o,i,a,s;for(var l in E)if(E.hasOwnProperty(l)){if(e=[],t=E[l],t.name&&(e.push(t.name.toLowerCase()),t.options&&t.options.aliases&&t.options.aliases.length))for(n=0;n<t.options.aliases.length;n++)e.push(t.options.aliases[n].toLowerCase());for(o=r(t.fn,"function")?t.fn():t.fn,i=0;i<e.length;i++)a=e[i],s=a.split("."),1===s.length?Modernizr[s[0]]=o:(!Modernizr[s[0]]||Modernizr[s[0]]instanceof Boolean||(Modernizr[s[0]]=new Boolean(Modernizr[s[0]])),Modernizr[s[0]][s[1]]=o),x.push((o?"":"no-")+s.join("-"))}}function i(e){var t=C.className,n=Modernizr._config.classPrefix||"";if(b&&(t=t.baseVal),Modernizr._config.enableJSClass){var r=new RegExp("(^|\\s)"+n+"no-js(\\s|$)");t=t.replace(r,"$1"+n+"js$2")}Modernizr._config.enableClasses&&(t+=" "+n+e.join(" "+n),b?C.className.baseVal=t:C.className=t)}function a(e,t){return!!~(""+e).indexOf(t)}function s(){return"function"!=typeof t.createElement?t.createElement(arguments[0]):b?t.createElementNS.call(t,"http://www.w3.org/2000/svg",arguments[0]):t.createElement.apply(t,arguments)}function l(){var e=t.body;return e||(e=s(b?"svg":"body"),e.fake=!0),e}function u(e,n,r,o){var i,a,u,f,c="modernizr",d=s("div"),p=l();if(parseInt(r,10))for(;r--;)u=s("div"),u.id=o?o[r]:c+(r+1),d.appendChild(u);return i=s("style"),i.type="text/css",i.id="s"+c,(p.fake?p:d).appendChild(i),p.appendChild(d),i.styleSheet?i.styleSheet.cssText=e:i.appendChild(t.createTextNode(e)),d.id=c,p.fake&&(p.style.background="",p.style.overflow="hidden",f=C.style.overflow,C.style.overflow="hidden",C.appendChild(p)),a=n(d,e),p.fake?(p.parentNode.removeChild(p),C.style.overflow=f,C.offsetHeight):d.parentNode.removeChild(d),!!a}function f(e){return e.replace(/([A-Z])/g,function(e,t){return"-"+t.toLowerCase()}).replace(/^ms-/,"-ms-")}function c(t,n,r){var o;if("getComputedStyle"in e){o=getComputedStyle.call(e,t,n);var i=e.console;if(null!==o)r&&(o=o.getPropertyValue(r));else if(i){var a=i.error?"error":"log";i[a].call(i,"getComputedStyle returning null, its possible modernizr test results are inaccurate")}}else o=!n&&t.currentStyle&&t.currentStyle[r];return o}function d(t,r){var o=t.length;if("CSS"in e&&"supports"in e.CSS){for(;o--;)if(e.CSS.supports(f(t[o]),r))return!0;return!1}if("CSSSupportsRule"in e){for(var i=[];o--;)i.push("("+f(t[o])+":"+r+")");return i=i.join(" or "),u("@supports ("+i+") { #modernizr { position: absolute; } }",function(e){return"absolute"==c(e,null,"position")})}return n}function p(e){return e.replace(/([a-z])-([a-z])/g,function(e,t,n){return t+n.toUpperCase()}).replace(/^-/,"")}function m(e,t,o,i){function l(){f&&(delete _.style,delete _.modElem)}if(i=r(i,"undefined")?!1:i,!r(o,"undefined")){var u=d(e,o);if(!r(u,"undefined"))return u}for(var f,c,m,h,v,g=["modernizr","tspan","samp"];!_.style&&g.length;)f=!0,_.modElem=s(g.shift()),_.style=_.modElem.style;for(m=e.length,c=0;m>c;c++)if(h=e[c],v=_.style[h],a(h,"-")&&(h=p(h)),_.style[h]!==n){if(i||r(o,"undefined"))return l(),"pfx"==t?h:!0;try{_.style[h]=o}catch(y){}if(_.style[h]!=v)return l(),"pfx"==t?h:!0}return l(),!1}function h(e,t){return function(){return e.apply(t,arguments)}}function v(e,t,n){var o;for(var i in e)if(e[i]in t)return n===!1?e[i]:(o=t[e[i]],r(o,"function")?h(o,n||t):o);return!1}function g(e,t,n,o,i){var a=e.charAt(0).toUpperCase()+e.slice(1),s=(e+" "+N.join(a+" ")+a).split(" ");return r(t,"string")||r(t,"undefined")?m(s,t,o,i):(s=(e+" "+j.join(a+" ")+a).split(" "),v(s,t,n))}function y(e,t,r){return g(e,n,n,t,r)}var E=[],S={_version:"3.6.0",_config:{classPrefix:"",enableClasses:!0,enableJSClass:!0,usePrefixes:!0},_q:[],on:function(e,t){var n=this;setTimeout(function(){t(n[e])},0)},addTest:function(e,t,n){E.push({name:e,fn:t,options:n})},addAsyncTest:function(e){E.push({name:null,fn:e})}},Modernizr=function(){};Modernizr.prototype=S,Modernizr=new Modernizr;var x=[],C=t.documentElement,b="svg"===C.nodeName.toLowerCase();b||!function(e,t){function n(e,t){var n=e.createElement("p"),r=e.getElementsByTagName("head")[0]||e.documentElement;return n.innerHTML="x<style>"+t+"</style>",r.insertBefore(n.lastChild,r.firstChild)}function r(){var e=w.elements;return"string"==typeof e?e.split(" "):e}function o(e,t){var n=w.elements;"string"!=typeof n&&(n=n.join(" ")),"string"!=typeof e&&(e=e.join(" ")),w.elements=n+" "+e,u(t)}function i(e){var t=b[e[x]];return t||(t={},C++,e[x]=C,b[C]=t),t}function a(e,n,r){if(n||(n=t),v)return n.createElement(e);r||(r=i(n));var o;return o=r.cache[e]?r.cache[e].cloneNode():S.test(e)?(r.cache[e]=r.createElem(e)).cloneNode():r.createElem(e),!o.canHaveChildren||E.test(e)||o.tagUrn?o:r.frag.appendChild(o)}function s(e,n){if(e||(e=t),v)return e.createDocumentFragment();n=n||i(e);for(var o=n.frag.cloneNode(),a=0,s=r(),l=s.length;l>a;a++)o.createElement(s[a]);return o}function l(e,t){t.cache||(t.cache={},t.createElem=e.createElement,t.createFrag=e.createDocumentFragment,t.frag=t.createFrag()),e.createElement=function(n){return w.shivMethods?a(n,e,t):t.createElem(n)},e.createDocumentFragment=Function("h,f","return function(){var n=f.cloneNode(),c=n.createElement;h.shivMethods&&("+r().join().replace(/[\w\-:]+/g,function(e){return t.createElem(e),t.frag.createElement(e),'c("'+e+'")'})+");return n}")(w,t.frag)}function u(e){e||(e=t);var r=i(e);return!w.shivCSS||h||r.hasCSS||(r.hasCSS=!!n(e,"article,aside,dialog,figcaption,figure,footer,header,hgroup,main,nav,section{display:block}mark{background:#FF0;color:#000}template{display:none}")),v||l(e,r),e}function f(e){for(var t,n=e.getElementsByTagName("*"),o=n.length,i=RegExp("^(?:"+r().join("|")+")$","i"),a=[];o--;)t=n[o],i.test(t.nodeName)&&a.push(t.applyElement(c(t)));return a}function c(e){for(var t,n=e.attributes,r=n.length,o=e.ownerDocument.createElement(T+":"+e.nodeName);r--;)t=n[r],t.specified&&o.setAttribute(t.nodeName,t.nodeValue);return o.style.cssText=e.style.cssText,o}function d(e){for(var t,n=e.split("{"),o=n.length,i=RegExp("(^|[\\s,>+~])("+r().join("|")+")(?=[[\\s,>+~#.:]|$)","gi"),a="$1"+T+"\\:$2";o--;)t=n[o]=n[o].split("}"),t[t.length-1]=t[t.length-1].replace(i,a),n[o]=t.join("}");return n.join("{")}function p(e){for(var t=e.length;t--;)e[t].removeNode()}function m(e){function t(){clearTimeout(a._removeSheetTimer),r&&r.removeNode(!0),r=null}var r,o,a=i(e),s=e.namespaces,l=e.parentWindow;return!_||e.printShived?e:("undefined"==typeof s[T]&&s.add(T),l.attachEvent("onbeforeprint",function(){t();for(var i,a,s,l=e.styleSheets,u=[],c=l.length,p=Array(c);c--;)p[c]=l[c];for(;s=p.pop();)if(!s.disabled&&N.test(s.media)){try{i=s.imports,a=i.length}catch(m){a=0}for(c=0;a>c;c++)p.push(i[c]);try{u.push(s.cssText)}catch(m){}}u=d(u.reverse().join("")),o=f(e),r=n(e,u)}),l.attachEvent("onafterprint",function(){p(o),clearTimeout(a._removeSheetTimer),a._removeSheetTimer=setTimeout(t,500)}),e.printShived=!0,e)}var h,v,g="3.7.3",y=e.html5||{},E=/^<|^(?:button|map|select|textarea|object|iframe|option|optgroup)$/i,S=/^(?:a|b|code|div|fieldset|h1|h2|h3|h4|h5|h6|i|label|li|ol|p|q|span|strong|style|table|tbody|td|th|tr|ul)$/i,x="_html5shiv",C=0,b={};!function(){try{var e=t.createElement("a");e.innerHTML="<xyz></xyz>",h="hidden"in e,v=1==e.childNodes.length||function(){t.createElement("a");var e=t.createDocumentFragment();return"undefined"==typeof e.cloneNode||"undefined"==typeof e.createDocumentFragment||"undefined"==typeof e.createElement}()}catch(n){h=!0,v=!0}}();var w={elements:y.elements||"abbr article aside audio bdi canvas data datalist details dialog figcaption figure footer header hgroup main mark meter nav output picture progress section summary template time video",version:g,shivCSS:y.shivCSS!==!1,supportsUnknownElements:v,shivMethods:y.shivMethods!==!1,type:"default",shivDocument:u,createElement:a,createDocumentFragment:s,addElements:o};e.html5=w,u(t);var N=/^$|\b(?:all|print)\b/,T="html5shiv",_=!v&&function(){var n=t.documentElement;return!("undefined"==typeof t.namespaces||"undefined"==typeof t.parentWindow||"undefined"==typeof n.applyElement||"undefined"==typeof n.removeNode||"undefined"==typeof e.attachEvent)}();w.type+=" print",w.shivPrint=m,m(t),"object"==typeof module&&module.exports&&(module.exports=w)}("undefined"!=typeof e?e:this,t),Modernizr.addTest("history",function(){var t=navigator.userAgent;return-1===t.indexOf("Android 2.")&&-1===t.indexOf("Android 4.0")||-1===t.indexOf("Mobile Safari")||-1!==t.indexOf("Chrome")||-1!==t.indexOf("Windows Phone")||"file:"===location.protocol?e.history&&"pushState"in e.history:!1});var w="Moz O ms Webkit",N=S._config.usePrefixes?w.split(" "):[];S._cssomPrefixes=N;var T={elem:s("modernizr")};Modernizr._q.push(function(){delete T.elem});var _={style:T.elem.style};Modernizr._q.unshift(function(){delete _.style});var j=S._config.usePrefixes?w.toLowerCase().split(" "):[];S._domPrefixes=j,S.testAllProps=g,S.testAllProps=y,Modernizr.addTest("flexbox",y("flexBasis","1px",!0)),Modernizr.addTest("flexboxtweener",y("flexAlign","end",!0)),o(),i(x),delete S.addTest,delete S.addAsyncTest;for(var P=0;P<Modernizr._q.length;P++)Modernizr._q[P]();e.Modernizr=Modernizr}(window,document);

data/app/assets/stylesheets/govuk_publishing_components/admin_styles_ie8.scss

@@ -0,0 +1,2 @@
+// Include all of the GOV.UK Frontend styles for IE8
+@import "../../../node_modules/govuk-frontend/all-ie8";

data/app/assets/stylesheets/govuk_publishing_components/components/_step-by-step-nav.scss

@@ -263,6 +263,8 @@ $top-border: solid 2px $grey-3;
   @include _core-font-generator(14px, 14px, 14px, 1.2, 1.2, false);
   display: block;
   color: $link-colour;
+  // core-font-generator sets this to none, so we need to override
+  text-transform: capitalize !important;
 
   .gem-c-step-nav--large & {
     @include _core-font-generator(16px, 14px, 16px, 1.2, 1.2, false);

data/app/views/govuk_publishing_components/components/_layout_for_admin.html.erb

@@ -4,7 +4,13 @@
     <meta name="robots" content="noindex,nofollow,noimageindex">
     <%= csrf_meta_tags %>
     <title><%= browser_title %></title>
-    <%= stylesheet_link_tag "govuk_publishing_components/admin_styles" %>
+    <!--[if !IE 8]><!-->
+      <%= stylesheet_link_tag "govuk_publishing_components/admin_styles" %>
+    <!--<![endif]-->
+    <!--[if IE 8]>
+      <%= stylesheet_link_tag "govuk_publishing_components/admin_styles_ie8" %>
+    <![endif]-->
+    <%= javascript_include_tag "govuk_publishing_components/vendor/modernizr" %>
   </head>
   <body class="govuk-template__body">
     <%= yield %>

data/app/views/govuk_publishing_components/components/_step_by_step_nav.html.erb

@@ -21,8 +21,8 @@
     class="gem-c-step-nav js-hidden <% unless small %>gem-c-step-nav--large<% end %>"
     <%= "data-remember" if remember_last_step %>
     <%= "data-id=#{tracking_id}" if tracking_id %>
-    data-show-text="<%= t("govuk_component.step_by_step_nav.show", default: "Show") %>"
-    data-hide-text="<%= t("govuk_component.step_by_step_nav.hide", default: "Hide") %>"
+    data-show-text="<%= t("govuk_component.step_by_step_nav.show", default: "show") %>"
+    data-hide-text="<%= t("govuk_component.step_by_step_nav.hide", default: "hide") %>"
     data-show-all-text="<%= t("govuk_component.step_by_step_nav.show_all", default: "Show all") %>"
     data-hide-all-text="<%= t("govuk_component.step_by_step_nav.hide_all", default: "Hide all") %>"
   >
@@ -54,9 +54,7 @@
                     <% if logic %>
                       <%= logic %>
                     <% else %>
-                      <%
-                        step_number += 1
-                      %>
+                      <% step_number += 1 %>
                       <span class="visuallyhidden">Step</span> <%= step_number %>
                     <% end %>
                   </span>

data/app/views/layouts/govuk_publishing_components/application.html.erb

@@ -18,7 +18,13 @@
   <% end %>
 
   <% if @component_doc && @component_doc.part_of_admin_layout? %>
+  <!--[if !IE 8]><!-->
     <%= stylesheet_link_tag "govuk_publishing_components/admin_styles" %>
+  <!--<![endif]-->
+  <!--[if IE 8]>
+    <%= stylesheet_link_tag "govuk_publishing_components/admin_styles_ie8" %>
+  <![endif]-->
+    <%= javascript_include_tag "govuk_publishing_components/vendor/modernizr" %>
   <% end %>
 
   <%= javascript_include_tag "component_guide/application" %>

data/config/initializers/assets.rb

@@ -1,6 +1,8 @@
 Rails.application.config.assets.precompile += %w(
+  govuk_publishing_components/vendor/modernizr.js
   govuk_publishing_components/admin_scripts.js
   govuk_publishing_components/admin_styles.css
+  govuk_publishing_components/admin_styles_ie8.css
   govuk_publishing_components/component_guide.css
   component_guide/all_components.css
   component_guide/all_components_print.css

data/lib/govuk_publishing_components/version.rb

@@ -1,3 +1,3 @@
 module GovukPublishingComponents
-  VERSION = '9.5.1'.freeze
+  VERSION = '9.5.2'.freeze
 end

data/node_modules/govuk-frontend/README.md

@@ -16,7 +16,7 @@ team](mailto:govuk-design-system-support@digital.cabinet-office.gov.uk) or get i
 There are 2 ways to start using GOV.UK Frontend in your app.
 
 Once installed, you will be able to use the code from the examples in the
-[GOV.UK Design System](https://www.gov.uk/design-system in your service.
+[GOV.UK Design System](https://www.gov.uk/design-system) in your service.
 
 ### 1. Install with npm (recommended)
 

data/node_modules/govuk-frontend/all.js

@@ -1677,8 +1677,10 @@ Tabs.prototype.getHref = function ($tab) {
 };
 
 function initAll () {
+  // Find all buttons with [role=button] on the document to enhance.
   new Button(document).init();
 
+  // Find all global details elements to enhance.
   var $details = document.querySelectorAll('details');
   nodeListForEach($details, function ($detail) {
     new Details($detail).init();
@@ -1689,7 +1691,7 @@ function initAll () {
     new Checkboxes($checkbox).init();
   });
 
-  // Find first Error Summary module to enhance.
+  // Find first error summary module to enhance.
   var $errorSummary = document.querySelector('[data-module="error-summary"]');
   new ErrorSummary($errorSummary).init();
 

data/node_modules/govuk-frontend/components/back-link/README.md

@@ -6,25 +6,41 @@ Link back component, to go back a page.
 
 ## Guidance
 
-Find out when to use the Back link component in your service in the [GOV.UK Design System](https://govuk-design-system-production.cloudapps.digital/components/back-link).
+Find out when to use the back link component in your service in the [GOV.UK Design System](https://design-system.service.gov.uk/components/back-link).
 
 ## Quick start examples
 
-### Component default
+### Back link
 
-[Preview the back-link component](http://govuk-frontend-review.herokuapp.com/components/back-link/preview)
+[Preview this example in the Frontend review app](http://govuk-frontend-review.herokuapp.com/components/back-link/preview)
 
 #### Markup
 
-    <a href="https://gov.uk" class="govuk-back-link">Back</a>
+    <a href="#" class="govuk-back-link">Back</a>
 
 #### Macro
 
-    {% from 'back-link/macro.njk' import govukBackLink %}
+    {% from "back-link/macro.njk" import govukBackLink %}
 
     {{ govukBackLink({
-      "href": "https://gov.uk",
-      "text": "Back"
+      "href": "#"
+    }) }}
+
+### Back link with custom text
+
+[Preview this example in the Frontend review app](http://govuk-frontend-review.herokuapp.com/components/back-link/with-custom-text/preview)
+
+#### Markup
+
+    <a href="#" class="govuk-back-link">Back to home</a>
+
+#### Macro
+
+    {% from "back-link/macro.njk" import govukBackLink %}
+
+    {{ govukBackLink({
+      "href": "#",
+      "text": "Back to home"
     }) }}
 
 ## Requirements

data/node_modules/govuk-frontend/components/breadcrumbs/README.md

@@ -6,13 +6,13 @@ The Breadcrumbs component helps users to understand where they are within a webs
 
 ## Guidance
 
-Find out when to use the Breadcrumbs component in your service in the [GOV.UK Design System](https://govuk-design-system-production.cloudapps.digital/components/breadcrumbs).
+Find out when to use the breadcrumbs component in your service in the [GOV.UK Design System](https://design-system.service.gov.uk/components/breadcrumbs).
 
 ## Quick start examples
 
-### Component default
+### Breadcrumbs
 
-[Preview the breadcrumbs component](http://govuk-frontend-review.herokuapp.com/components/breadcrumbs/preview)
+[Preview this example in the Frontend review app](http://govuk-frontend-review.herokuapp.com/components/breadcrumbs/preview)
 
 #### Markup
 
@@ -20,7 +20,7 @@ Find out when to use the Breadcrumbs component in your service in the [GOV.UK De
       <ol class="govuk-breadcrumbs__list">
 
         <li class="govuk-breadcrumbs__list-item">
-          <a class="govuk-breadcrumbs__link" href="/section">Section 1</a>
+          <a class="govuk-breadcrumbs__link" href="/section">Section</a>
         </li>
 
         <li class="govuk-breadcrumbs__list-item">
@@ -32,12 +32,12 @@ Find out when to use the Breadcrumbs component in your service in the [GOV.UK De
 
 #### Macro
 
-    {% from 'breadcrumbs/macro.njk' import govukBreadcrumbs %}
+    {% from "breadcrumbs/macro.njk" import govukBreadcrumbs %}
 
     {{ govukBreadcrumbs({
       "items": [
         {
-          "text": "Section 1",
+          "text": "Section",
           "href": "/section"
         },
         {
@@ -47,9 +47,9 @@ Find out when to use the Breadcrumbs component in your service in the [GOV.UK De
       ]
     }) }}
 
-### Breadcrumbs--single-section
+### Breadcrumbs with one level
 
-[Preview the breadcrumbs--single-section example](http://govuk-frontend-review.herokuapp.com/components/breadcrumbs/single-section/preview)
+[Preview this example in the Frontend review app](http://govuk-frontend-review.herokuapp.com/components/breadcrumbs/with-one-level/preview)
 
 #### Markup
 
@@ -57,7 +57,7 @@ Find out when to use the Breadcrumbs component in your service in the [GOV.UK De
       <ol class="govuk-breadcrumbs__list">
 
         <li class="govuk-breadcrumbs__list-item">
-          <a class="govuk-breadcrumbs__link" href="/section">Section 1</a>
+          <a class="govuk-breadcrumbs__link" href="/section">Section</a>
         </li>
 
       </ol>
@@ -65,20 +65,20 @@ Find out when to use the Breadcrumbs component in your service in the [GOV.UK De
 
 #### Macro
 
-    {% from 'breadcrumbs/macro.njk' import govukBreadcrumbs %}
+    {% from "breadcrumbs/macro.njk" import govukBreadcrumbs %}
 
     {{ govukBreadcrumbs({
       "items": [
         {
-          "text": "Section 1",
+          "text": "Section",
           "href": "/section"
         }
       ]
     }) }}
 
-### Breadcrumbs--many-breadcrumbs
+### Breadcrumbs with multiple levels
 
-[Preview the breadcrumbs--many-breadcrumbs example](http://govuk-frontend-review.herokuapp.com/components/breadcrumbs/many-breadcrumbs/preview)
+[Preview this example in the Frontend review app](http://govuk-frontend-review.herokuapp.com/components/breadcrumbs/with-multiple-levels/preview)
 
 #### Markup
 
@@ -90,15 +90,15 @@ Find out when to use the Breadcrumbs component in your service in the [GOV.UK De
         </li>
 
         <li class="govuk-breadcrumbs__list-item">
-          <a class="govuk-breadcrumbs__link" href="/section">Section 3</a>
+          <a class="govuk-breadcrumbs__link" href="/section">Section</a>
         </li>
 
         <li class="govuk-breadcrumbs__list-item">
-          <a class="govuk-breadcrumbs__link" href="/section/sub-section">Sub-section 1</a>
+          <a class="govuk-breadcrumbs__link" href="/section/sub-section">Sub-section</a>
         </li>
 
         <li class="govuk-breadcrumbs__list-item">
-          <a class="govuk-breadcrumbs__link" href="/section/sub-section/sub-sub-section">Sub Sub-section 1</a>
+          <a class="govuk-breadcrumbs__link" href="/section/sub-section/sub-sub-section">Sub Sub-section</a>
         </li>
 
       </ol>
@@ -106,7 +106,7 @@ Find out when to use the Breadcrumbs component in your service in the [GOV.UK De
 
 #### Macro
 
-    {% from 'breadcrumbs/macro.njk' import govukBreadcrumbs %}
+    {% from "breadcrumbs/macro.njk" import govukBreadcrumbs %}
 
     {{ govukBreadcrumbs({
       "items": [
@@ -115,23 +115,23 @@ Find out when to use the Breadcrumbs component in your service in the [GOV.UK De
           "href": "/"
         },
         {
-          "text": "Section 3",
+          "text": "Section",
           "href": "/section"
         },
         {
-          "text": "Sub-section 1",
+          "text": "Sub-section",
           "href": "/section/sub-section"
         },
         {
-          "text": "Sub Sub-section 1",
+          "text": "Sub Sub-section",
           "href": "/section/sub-section/sub-sub-section"
         }
       ]
     }) }}
 
-### Breadcrumbs--no-home-section
+### Breadcrumbs without the home section
 
-[Preview the breadcrumbs--no-home-section example](http://govuk-frontend-review.herokuapp.com/components/breadcrumbs/no-home-section/preview)
+[Preview this example in the Frontend review app](http://govuk-frontend-review.herokuapp.com/components/breadcrumbs/without-the-home-section/preview)
 
 #### Markup
 
@@ -151,7 +151,7 @@ Find out when to use the Breadcrumbs component in your service in the [GOV.UK De
 
 #### Macro
 
-    {% from 'breadcrumbs/macro.njk' import govukBreadcrumbs %}
+    {% from "breadcrumbs/macro.njk" import govukBreadcrumbs %}
 
     {{ govukBreadcrumbs({
       "items": [
@@ -166,9 +166,9 @@ Find out when to use the Breadcrumbs component in your service in the [GOV.UK De
       ]
     }) }}
 
-### Breadcrumbs--last-breadcrumb-is-current-page
+### Breadcrumbs with last breadcrumb as current page
 
-[Preview the breadcrumbs--last-breadcrumb-is-current-page example](http://govuk-frontend-review.herokuapp.com/components/breadcrumbs/last-breadcrumb-is-current-page/preview)
+[Preview this example in the Frontend review app](http://govuk-frontend-review.herokuapp.com/components/breadcrumbs/with-last-breadcrumb-as-current-page/preview)
 
 #### Markup
 
@@ -190,7 +190,7 @@ Find out when to use the Breadcrumbs component in your service in the [GOV.UK De
 
 #### Macro
 
-    {% from 'breadcrumbs/macro.njk' import govukBreadcrumbs %}
+    {% from "breadcrumbs/macro.njk" import govukBreadcrumbs %}
 
     {{ govukBreadcrumbs({
       "items": [

data/node_modules/govuk-frontend/components/button/README.md

@@ -6,15 +6,15 @@ A button is an element that allows users to carry out an action on a GOV.UK page
 
 ## Guidance
 
-Find out when to use the Button component in your service in the [GOV.UK Design System](https://govuk-design-system-production.cloudapps.digital/components/button).
+Find out when to use the button component in your service in the [GOV.UK Design System](https://design-system.service.gov.uk/components/button).
 
 ## Quick start examples
 
 Buttons are configured to perform an action and they can have a different look. For example, they can be disabled until a valid action has been performed by the user.
 
-### Component default
+### Button
 
-[Preview the button component](http://govuk-frontend-review.herokuapp.com/components/button/preview)
+[Preview this example in the Frontend review app](http://govuk-frontend-review.herokuapp.com/components/button/preview)
 
 #### Markup
 
@@ -24,15 +24,15 @@ Buttons are configured to perform an action and they can have a different look.
 
 #### Macro
 
-    {% from 'button/macro.njk' import govukButton %}
+    {% from "button/macro.njk" import govukButton %}
 
     {{ govukButton({
       "text": "Save and continue"
     }) }}
 
-### Button--disabled
+### Button disabled
 
-[Preview the button--disabled example](http://govuk-frontend-review.herokuapp.com/components/button/disabled/preview)
+[Preview this example in the Frontend review app](http://govuk-frontend-review.herokuapp.com/components/button/disabled/preview)
 
 #### Markup
 
@@ -42,16 +42,16 @@ Buttons are configured to perform an action and they can have a different look.
 
 #### Macro
 
-    {% from 'button/macro.njk' import govukButton %}
+    {% from "button/macro.njk" import govukButton %}
 
     {{ govukButton({
       "text": "Disabled button",
       "disabled": true
     }) }}
 
-### Button--link
+### Button link
 
-[Preview the button--link example](http://govuk-frontend-review.herokuapp.com/components/button/link/preview)
+[Preview this example in the Frontend review app](http://govuk-frontend-review.herokuapp.com/components/button/link/preview)
 
 #### Markup
 
@@ -61,16 +61,16 @@ Buttons are configured to perform an action and they can have a different look.
 
 #### Macro
 
-    {% from 'button/macro.njk' import govukButton %}
+    {% from "button/macro.njk" import govukButton %}
 
     {{ govukButton({
       "text": "Link button",
       "href": "/"
     }) }}
 
-### Button--disabled-link
+### Button link disabled
 
-[Preview the button--disabled-link example](http://govuk-frontend-review.herokuapp.com/components/button/disabled-link/preview)
+[Preview this example in the Frontend review app](http://govuk-frontend-review.herokuapp.com/components/button/link-disabled/preview)
 
 #### Markup
 
@@ -80,7 +80,7 @@ Buttons are configured to perform an action and they can have a different look.
 
 #### Macro
 
-    {% from 'button/macro.njk' import govukButton %}
+    {% from "button/macro.njk" import govukButton %}
 
     {{ govukButton({
       "text": "Disabled link button",
@@ -88,9 +88,9 @@ Buttons are configured to perform an action and they can have a different look.
       "disabled": true
     }) }}
 
-### Button--start-link
+### Button start link
 
-[Preview the button--start-link example](http://govuk-frontend-review.herokuapp.com/components/button/start-link/preview)
+[Preview this example in the Frontend review app](http://govuk-frontend-review.herokuapp.com/components/button/start-link/preview)
 
 #### Markup
 
@@ -100,7 +100,7 @@ Buttons are configured to perform an action and they can have a different look.
 
 #### Macro
 
-    {% from 'button/macro.njk' import govukButton %}
+    {% from "button/macro.njk" import govukButton %}
 
     {{ govukButton({
       "text": "Start now link button",
@@ -108,9 +108,9 @@ Buttons are configured to perform an action and they can have a different look.
       "classes": "govuk-button--start"
     }) }}
 
-### Button--explicit-input-button
+### Button input
 
-[Preview the button--explicit-input-button example](http://govuk-frontend-review.herokuapp.com/components/button/explicit-input-button/preview)
+[Preview this example in the Frontend review app](http://govuk-frontend-review.herokuapp.com/components/button/input/preview)
 
 #### Markup
 
@@ -118,7 +118,7 @@ Buttons are configured to perform an action and they can have a different look.
 
 #### Macro
 
-    {% from 'button/macro.njk' import govukButton %}
+    {% from "button/macro.njk" import govukButton %}
 
     {{ govukButton({
       "element": "input",
@@ -126,9 +126,9 @@ Buttons are configured to perform an action and they can have a different look.
       "text": "Start now"
     }) }}
 
-### Button--explicit-input-button-disabled
+### Button input disabled
 
-[Preview the button--explicit-input-button-disabled example](http://govuk-frontend-review.herokuapp.com/components/button/explicit-input-button-disabled/preview)
+[Preview this example in the Frontend review app](http://govuk-frontend-review.herokuapp.com/components/button/input-disabled/preview)
 
 #### Markup
 
@@ -136,7 +136,7 @@ Buttons are configured to perform an action and they can have a different look.
 
 #### Macro
 
-    {% from 'button/macro.njk' import govukButton %}
+    {% from "button/macro.njk" import govukButton %}
 
     {{ govukButton({
       "element": "input",