From a7ee876ec6d272d264fd9f0526e879621a3c1a6b Mon Sep 17 00:00:00 2001
From: Devon Rueckner <devon.rueckner@gmail.com>
Date: Wed, 23 Sep 2020 16:09:59 -0700
Subject: [PATCH 1/7] WIP on versions

---
 docs/common/DocsAnchorTarget.vue |  4 ++--
 docs/pages/versions.vue          | 31 +++++++++++++++++++++++++++++++
 docs/tableOfContents.js          |  4 ++++
 3 files changed, 37 insertions(+), 2 deletions(-)
 create mode 100644 docs/pages/versions.vue

diff --git a/docs/common/DocsAnchorTarget.vue b/docs/common/DocsAnchorTarget.vue
index fb9d6cab5..c871fe125 100644
--- a/docs/common/DocsAnchorTarget.vue
+++ b/docs/common/DocsAnchorTarget.vue
@@ -34,8 +34,8 @@
             log.warn(`'anchor' prop value '${value}' must start with a '#'`);
             return false;
           }
-          if (!value.match(/^#[a-zA-Z0-9_-]*$/)) {
-            log.warn(`'anchor' prop value '${value}' must match /^#[a-zA-Z0-9_-]*$/`);
+          if (!value.match(/^#[\w.:]*$/)) {
+            log.warn(`'anchor' prop value '${value}' invalid`);
             return false;
           }
           return true;
diff --git a/docs/pages/versions.vue b/docs/pages/versions.vue
new file mode 100644
index 000000000..930155b65
--- /dev/null
+++ b/docs/pages/versions.vue
@@ -0,0 +1,31 @@
+<template>
+
+  <DocsPageTemplate>
+
+    <DocsPageSection>
+      <p>
+        Releases are specified as tags in the <DocsExternalLink href="https://github.com/learningequality/kolibri-design-system/releases">
+          Github releases page
+        </DocsExternalLink>
+      </p>
+    </DocsPageSection>
+
+    <DocsPageSection title="v0.2.x" anchor="#v0.2.x">
+      <p>
+        https://github.com/learningequality/kolibri-design-system/releases
+      </p>
+    </DocsPageSection>
+
+  </DocsPageTemplate>
+
+</template>
+
+
+<script>
+
+  export default {};
+
+</script>
+
+
+<style lang="scss" scoped></style>
diff --git a/docs/tableOfContents.js b/docs/tableOfContents.js
index 058bd66ef..db5dba2bf 100644
--- a/docs/tableOfContents.js
+++ b/docs/tableOfContents.js
@@ -64,6 +64,10 @@ export default [
         path: '/principles',
         title: 'Design principles',
       }),
+      new Page({
+        path: '/versions',
+        title: 'Version history',
+      }),
     ],
   }),
   new Section({

From 0e5db5d242abf9822a843386fe528c1ff26fce24 Mon Sep 17 00:00:00 2001
From: Devon Rueckner <devon.rueckner@gmail.com>
Date: Wed, 23 Sep 2020 17:03:17 -0700
Subject: [PATCH 2/7] factor github link out into a reusable docs component

---
 docs/assets/definitions.scss                |   2 +-
 docs/common/DocsAnchorTarget.vue            |   4 +-
 docs/common/DocsGithubLink.vue              | 107 ++++++++++++++++++++
 docs/common/DocsPageTemplate/BranchLink.vue |  48 +++++++++
 docs/common/DocsPageTemplate/GitHubLink.vue |  66 ------------
 docs/common/DocsPageTemplate/Header.vue     |   6 +-
 docs/pages/versions.vue                     |  21 ++--
 docs/plugins/load-common-components.js      |   2 +
 8 files changed, 178 insertions(+), 78 deletions(-)
 create mode 100644 docs/common/DocsGithubLink.vue
 create mode 100644 docs/common/DocsPageTemplate/BranchLink.vue
 delete mode 100644 docs/common/DocsPageTemplate/GitHubLink.vue

diff --git a/docs/assets/definitions.scss b/docs/assets/definitions.scss
index b90560541..53475f465 100644
--- a/docs/assets/definitions.scss
+++ b/docs/assets/definitions.scss
@@ -4,5 +4,5 @@ $code-color: #696680;
 $link-color: #368d74;
 $link-hover-color: #26614d;
 $selection-color: #f0e7ed;
-$basic-transition: color 0.25s ease;
+$basic-transition: color 0.25s ease, fill 0.25s ease;
 $nav-width: 260px;
diff --git a/docs/common/DocsAnchorTarget.vue b/docs/common/DocsAnchorTarget.vue
index c871fe125..994beadce 100644
--- a/docs/common/DocsAnchorTarget.vue
+++ b/docs/common/DocsAnchorTarget.vue
@@ -31,11 +31,11 @@
         type: String,
         validator(value) {
           if (!value.startsWith('#')) {
-            log.warn(`'anchor' prop value '${value}' must start with a '#'`);
+            log.error(`'anchor' prop value '${value}' must start with a '#'`);
             return false;
           }
           if (!value.match(/^#[\w.:]*$/)) {
-            log.warn(`'anchor' prop value '${value}' invalid`);
+            log.error(`'anchor' prop value '${value}' invalid`);
             return false;
           }
           return true;
diff --git a/docs/common/DocsGithubLink.vue b/docs/common/DocsGithubLink.vue
new file mode 100644
index 000000000..8ea0d1b20
--- /dev/null
+++ b/docs/common/DocsGithubLink.vue
@@ -0,0 +1,107 @@
+<template>
+
+  <a :href="linkUrl" target="_blank">
+    <svg
+      class="logo"
+      role="img"
+      viewBox="0 0 24 24"
+      xmlns="http://www.w3.org/2000/svg"
+    >
+      <title>GitHub</title>
+      <path d="M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12" />
+    </svg><span>{{ linkText }}</span>
+  </a>
+
+</template>
+
+
+<script>
+
+  import log from 'loglevel';
+
+  function validator(value) {
+    if (typeof value === 'string') {
+      if (value.startsWith('#')) {
+        log.error(`PR or issue number '${value}' should not start with a '#'`);
+        return false;
+      }
+      if (!value.match(/^\d+$/)) {
+        log.error(`PR or issue number '${value}' invalid`);
+        return false;
+      }
+    }
+    return true;
+  }
+
+  export default {
+    name: 'DocsExternalLink',
+    props: {
+      /**
+       * If provided, set the link text
+       */
+      text: {
+        type: String,
+        required: false,
+      },
+      /**
+       * If provided, set the link URL
+       */
+      href: {
+        type: String,
+        required: false,
+      },
+      /**
+       * If provided, create a link to a RP in the design-system repo
+       */
+      pull: {
+        type: [String, Number],
+        required: false,
+        validator,
+      },
+      /**
+       * If provided, create a link to an issue in the design-system repo
+       */
+      issue: {
+        type: [String, Number],
+        required: false,
+        validator,
+      },
+    },
+    computed: {
+      linkText() {
+        if (this.text) return this.text;
+        if (this.pull) return `#${this.pull}`;
+        if (this.issue) return `#${this.issue}`;
+        return this.linkUrl;
+      },
+      linkUrl() {
+        if (this.href) return this.href;
+        if (this.pull)
+          return `https://github.com/learningequality/kolibri-design-system/pull/${this.pull}`;
+        if (this.issue)
+          return `https://github.com/learningequality/kolibri-design-system/issue/${this.issue}`;
+        return undefined;
+      },
+    },
+    mounted() {
+      if (this.pull && this.issue) {
+        log.warn("Pass either 'pull' or 'issue', not both");
+      }
+    },
+  };
+
+</script>
+
+
+<style lang="scss" scoped>
+
+  .logo {
+    position: relative;
+    top: -1px;
+    width: 16px;
+    height: 16px;
+    margin-right: 4px;
+    vertical-align: middle;
+  }
+
+</style>
diff --git a/docs/common/DocsPageTemplate/BranchLink.vue b/docs/common/DocsPageTemplate/BranchLink.vue
new file mode 100644
index 000000000..36c883ed0
--- /dev/null
+++ b/docs/common/DocsPageTemplate/BranchLink.vue
@@ -0,0 +1,48 @@
+<template>
+
+  <div class="link-wrapper">
+    <DocsGithubLink
+      v-if="showLink"
+      :href="linkUrl"
+      :text="linkText"
+    />
+    <span v-else>
+      Local environment
+    </span>
+    <span>| <DocsInternalLink text="Version history" href="/versions" /></span>
+  </div>
+
+</template>
+
+
+<script>
+
+  import environment from '~/environment';
+
+  export default {
+    name: 'BranchLink',
+    computed: {
+      showLink() {
+        return environment && !environment.local;
+      },
+      linkUrl() {
+        return environment.url;
+      },
+      linkText() {
+        return environment.branch;
+      },
+    },
+  };
+
+</script>
+
+
+<style lang="scss" scoped>
+
+  .link-wrapper {
+    margin: 18px;
+    font-size: 14px;
+    font-weight: normal;
+  }
+
+</style>
diff --git a/docs/common/DocsPageTemplate/GitHubLink.vue b/docs/common/DocsPageTemplate/GitHubLink.vue
deleted file mode 100644
index b0f1573b2..000000000
--- a/docs/common/DocsPageTemplate/GitHubLink.vue
+++ /dev/null
@@ -1,66 +0,0 @@
-<template>
-
-  <div class="link-wrapper">
-    <a
-      v-if="showLink"
-      :href="linkUrl"
-      target="_blank"
-    >
-      <svg
-        class="logo"
-        role="img"
-        viewBox="0 0 24 24"
-        xmlns="http://www.w3.org/2000/svg"
-      >
-        <title>GitHub icon</title>
-        <path d="M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12" />
-      </svg><span>{{ linkText }}</span>
-    </a>
-    <span v-else>
-      Local environment
-    </span>
-  </div>
-
-</template>
-
-
-<script>
-
-  import environment from '~/environment';
-
-  export default {
-    name: 'GitHubLink',
-    computed: {
-      showLink() {
-        return environment && !environment.local;
-      },
-      linkUrl() {
-        return environment.url;
-      },
-      linkText() {
-        return environment.branch;
-      },
-    },
-  };
-
-</script>
-
-
-<style lang="scss" scoped>
-
-  .link-wrapper {
-    margin: 18px;
-    font-size: 14px;
-    font-weight: normal;
-  }
-
-  .logo {
-    position: relative;
-    top: -2px;
-    width: 16px;
-    height: 16px;
-    margin-right: 8px;
-    vertical-align: middle;
-  }
-
-</style>
diff --git a/docs/common/DocsPageTemplate/Header.vue b/docs/common/DocsPageTemplate/Header.vue
index cc27cd690..55fcfe0eb 100644
--- a/docs/common/DocsPageTemplate/Header.vue
+++ b/docs/common/DocsPageTemplate/Header.vue
@@ -13,7 +13,7 @@
           <span class="visuallyhidden">link to current page</span>
         </a>
       </h1>
-      <GitHubLink style="float: right" />
+      <BranchLink style="float: right" />
     </div>
     <div style="clear: both;"></div>
     <ul v-if="sections.length" class="nav">
@@ -28,12 +28,12 @@
 
 <script>
 
-  import GitHubLink from './GitHubLink.vue';
+  import BranchLink from './BranchLink.vue';
 
   export default {
     name: 'Header',
     components: {
-      GitHubLink,
+      BranchLink,
     },
     props: {
       sections: {
diff --git a/docs/pages/versions.vue b/docs/pages/versions.vue
index 930155b65..a669c66b0 100644
--- a/docs/pages/versions.vue
+++ b/docs/pages/versions.vue
@@ -2,17 +2,26 @@
 
   <DocsPageTemplate>
 
-    <DocsPageSection>
+    <DocsPageSection title="Overview" anchor="#overview">
       <p>
-        Releases are specified as tags in the <DocsExternalLink href="https://github.com/learningequality/kolibri-design-system/releases">
-          Github releases page
-        </DocsExternalLink>
+        Releases are specified as tags in the <DocsExternalLink text="Github releases page" href="https://github.com/learningequality/kolibri-design-system/releases" />
       </p>
     </DocsPageSection>
 
-    <DocsPageSection title="v0.2.x" anchor="#v0.2.x">
+    <DocsPageSection title="Version 0.2" anchor="#0.2">
+      <h3>0.2.1</h3>
       <p>
-        https://github.com/learningequality/kolibri-design-system/releases
+        info
+      </p>
+      <h3>0.2.0</h3>
+      <p>
+        info
+      </p>
+    </DocsPageSection>
+
+    <DocsPageSection title="Version 0.1" anchor="#0.1">
+      <p>
+        The design system here is based on a set of internal Kolibri components and the Kolibri Style Guide, which was first introduced into the Kolibri code base <DocsExternalLink text="in version 0.6" href="https://github.com/learningequality/kolibri/tree/release-v0.6.x/kolibri/plugins/style_guide" />. This remained until <DocsExternalLink text="version 0.13" href="https://github.com/learningequality/kolibri/tree/release-v0.13.x/kolibri/plugins/style_guide" /> after which the content was migrated here.
       </p>
     </DocsPageSection>
 
diff --git a/docs/plugins/load-common-components.js b/docs/plugins/load-common-components.js
index 0167e7d41..35cedbb26 100644
--- a/docs/plugins/load-common-components.js
+++ b/docs/plugins/load-common-components.js
@@ -2,6 +2,7 @@ import Vue from 'vue';
 
 import VueSimpleMarkdown from 'vue-simple-markdown';
 import DocsExternalLink from '~/common/DocsExternalLink';
+import DocsGithubLink from '~/common/DocsGithubLink';
 import DocsInternalLink from '~/common/DocsInternalLink';
 import DocsAnchorTarget from '~/common/DocsAnchorTarget';
 import DocsPageSection from '~/common/DocsPageSection';
@@ -14,6 +15,7 @@ Vue.component('DocsPageSection', DocsPageSection);
 Vue.component('DocsInternalLink', DocsInternalLink);
 Vue.component('DocsAnchorTarget', DocsAnchorTarget);
 Vue.component('DocsExternalLink', DocsExternalLink);
+Vue.component('DocsGithubLink', DocsGithubLink);
 Vue.component('DocsShow', DocsShow);
 Vue.component('DocsDoNot', DocsDoNot);
 

From 104d3357c0eda644fb1987e31742cc2c79a229ed Mon Sep 17 00:00:00 2001
From: Devon Rueckner <devon.rueckner@gmail.com>
Date: Tue, 10 Nov 2020 16:46:57 -0800
Subject: [PATCH 3/7] fix broken link

---
 docs/pages/inclusive.vue | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/pages/inclusive.vue b/docs/pages/inclusive.vue
index 3095c55d4..55759e2e1 100644
--- a/docs/pages/inclusive.vue
+++ b/docs/pages/inclusive.vue
@@ -80,7 +80,7 @@
         Like with keyboard navigation, using the built-in components is a good way to
         ensure compatibility with screen readers. However, it's also critical to test
         all new functionality. See this
-        <DocsExternalLink href="https://github.com/learningequality/kolibri/wiki/Accessibility-Resources-(Tools)" text="comprehensive list of A11y testing tools" />.
+        <DocsExternalLink href="https://kolibri-dev.readthedocs.io/en/develop/manual_testing/a11y_resources/index.html" text="comprehensive list of A11y testing tools" />.
       </p>
 
       <p>

From dda827a97be1021112d74d79290c2c8839d48f5d Mon Sep 17 00:00:00 2001
From: Devon Rueckner <devon.rueckner@gmail.com>
Date: Tue, 10 Nov 2020 16:58:08 -0800
Subject: [PATCH 4/7] update versions doc

---
 docs/pages/versions.vue | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/pages/versions.vue b/docs/pages/versions.vue
index a669c66b0..d39115757 100644
--- a/docs/pages/versions.vue
+++ b/docs/pages/versions.vue
@@ -11,17 +11,17 @@
     <DocsPageSection title="Version 0.2" anchor="#0.2">
       <h3>0.2.1</h3>
       <p>
-        info
+        Fixed regression related to all external links opening in new tabs - <DocsGithubLink pull="93" />
       </p>
       <h3>0.2.0</h3>
       <p>
-        info
+        This was the first release of the Design System, with documentation written in a Nuxt-based statically-generated site. The focus was on migrating components out of the Kolibri and making them reusable in a shared component library.
       </p>
     </DocsPageSection>
 
     <DocsPageSection title="Version 0.1" anchor="#0.1">
       <p>
-        The design system here is based on a set of internal Kolibri components and the Kolibri Style Guide, which was first introduced into the Kolibri code base <DocsExternalLink text="in version 0.6" href="https://github.com/learningequality/kolibri/tree/release-v0.6.x/kolibri/plugins/style_guide" />. This remained until <DocsExternalLink text="version 0.13" href="https://github.com/learningequality/kolibri/tree/release-v0.13.x/kolibri/plugins/style_guide" /> after which the content was migrated here.
+        The design system was originally based on a set of internal Kolibri components and their use as documented in the Kolibri Style Guide, which was first introduced into the Kolibri code base <DocsExternalLink text="in version 0.6" href="https://github.com/learningequality/kolibri/tree/release-v0.6.x/kolibri/plugins/style_guide" />. This remained until <DocsExternalLink text="version 0.13" href="https://github.com/learningequality/kolibri/tree/release-v0.13.x/kolibri/plugins/style_guide" /> after which the content was migrated here.
       </p>
     </DocsPageSection>
 

From 476b465d43d6c3f82396033577d287120cbabb35 Mon Sep 17 00:00:00 2001
From: Devon Rueckner <devon.rueckner@gmail.com>
Date: Tue, 10 Nov 2020 17:32:03 -0800
Subject: [PATCH 5/7] fleshed out 0.2.1 changelog

---
 docs/pages/versions.vue | 27 ++++++++++++++++++++++++---
 1 file changed, 24 insertions(+), 3 deletions(-)

diff --git a/docs/pages/versions.vue b/docs/pages/versions.vue
index d39115757..9d65f0d10 100644
--- a/docs/pages/versions.vue
+++ b/docs/pages/versions.vue
@@ -10,9 +10,30 @@
 
     <DocsPageSection title="Version 0.2" anchor="#0.2">
       <h3>0.2.1</h3>
-      <p>
-        Fixed regression related to all external links opening in new tabs - <DocsGithubLink pull="93" />
-      </p>
+      <h4>Content updates</h4>
+      <ul>
+        <li>Added design principles documentation - <DocsGithubLink pull="95" /></li>
+        <li>Added errors documentation - <DocsGithubLink pull="97" /></li>
+        <li>Added switches documentation - <DocsGithubLink pull="105" /></li>
+        <li>Added menu documentation - <DocsGithubLink pull="106" /></li>
+        <li>Added 'email', 'sidebar', and 'add' icons - <DocsGithubLink pull="110" /></li>
+      </ul>
+      <h4>Library updates</h4>
+      <ul>
+        <li>Added 'email', 'sidebar', and 'add' icons - <DocsGithubLink pull="110" /></li>
+        <li>Updated 'clipboard' icon - <DocsGithubLink pull="121" /></li>
+        <li>Fixed z-order bug in icon button - <DocsGithubLink pull="95" />, <DocsGithubLink pull="122" /></li>
+      </ul>
+      <h4>Docs site updates</h4>
+      <ul>
+        <li>Added support for exporting icons to user documentation - <DocsGithubLink pull="104" /></li>
+        <li>Documentation bugs and improvements - <DocsGithubLink pull="112" />, <DocsGithubLink pull="114" />, <DocsGithubLink pull="115" /></li>
+      </ul>
+      <h3>0.2.1</h3>
+      <h4>Library updates</h4>
+      <ul>
+        <li>Fixed regression related to external links opening in new tabs - <DocsGithubLink pull="93" /></li>
+      </ul>
       <h3>0.2.0</h3>
       <p>
         This was the first release of the Design System, with documentation written in a Nuxt-based statically-generated site. The focus was on migrating components out of the Kolibri and making them reusable in a shared component library.

From 74245079cfb0bee7c4433b2374d70e359cb273ce Mon Sep 17 00:00:00 2001
From: Devon Rueckner <devon.rueckner@gmail.com>
Date: Wed, 11 Nov 2020 16:19:12 -0800
Subject: [PATCH 6/7] remove duplicate entry

---
 docs/pages/versions.vue | 1 -
 1 file changed, 1 deletion(-)

diff --git a/docs/pages/versions.vue b/docs/pages/versions.vue
index 9d65f0d10..441172dae 100644
--- a/docs/pages/versions.vue
+++ b/docs/pages/versions.vue
@@ -16,7 +16,6 @@
         <li>Added errors documentation - <DocsGithubLink pull="97" /></li>
         <li>Added switches documentation - <DocsGithubLink pull="105" /></li>
         <li>Added menu documentation - <DocsGithubLink pull="106" /></li>
-        <li>Added 'email', 'sidebar', and 'add' icons - <DocsGithubLink pull="110" /></li>
       </ul>
       <h4>Library updates</h4>
       <ul>

From 3609c469e34ee81f60065cee1982598173e55203 Mon Sep 17 00:00:00 2001
From: Devon Rueckner <devon.rueckner@gmail.com>
Date: Wed, 11 Nov 2020 16:28:11 -0800
Subject: [PATCH 7/7] add error message and fix comment

---
 docs/common/DocsGithubLink.vue | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/common/DocsGithubLink.vue b/docs/common/DocsGithubLink.vue
index 8ea0d1b20..6247f206d 100644
--- a/docs/common/DocsGithubLink.vue
+++ b/docs/common/DocsGithubLink.vue
@@ -51,7 +51,7 @@
         required: false,
       },
       /**
-       * If provided, create a link to a RP in the design-system repo
+       * If provided, create a link to a PR in the design-system repo
        */
       pull: {
         type: [String, Number],
@@ -80,6 +80,7 @@
           return `https://github.com/learningequality/kolibri-design-system/pull/${this.pull}`;
         if (this.issue)
           return `https://github.com/learningequality/kolibri-design-system/issue/${this.issue}`;
+        log.error(`No URL, PR, or issue provided`);
         return undefined;
       },
     },