From 3292729d536e3d5ea354b2988b70f4e0455dd9e8 Mon Sep 17 00:00:00 2001
From: "Alexander (M2)" <alexander@gamv.ca>
Date: Sun, 28 Jul 2024 15:30:51 -0400
Subject: [PATCH] Update pattern documentation

---
 public/patterns/core/breakpoints/index.html | 15 +++-
 public/patterns/core/header/index.html      | 58 +-------------
 public/patterns/core/sticky-note/index.html | 20 +++--
 public/patterns/core/switch/index.html      | 27 +++++--
 public/patterns/core/tabs/index.html        | 41 ++++++----
 public/patterns/core/tooltip/index.html     | 20 +++--
 src/pg/patterns/core/breakpoints/index.pug  | 14 +++-
 src/pg/patterns/core/header/header.css      | 54 +------------
 src/pg/patterns/core/header/index.pug       |  3 +-
 src/pg/patterns/core/sticky-note/index.pug  | 28 +++++--
 src/pg/patterns/core/switch/index.pug       | 29 +++++--
 src/pg/patterns/core/switch/switch.css      |  6 +-
 src/pg/patterns/core/tabs/index.pug         | 88 ++++++++++++---------
 src/pg/patterns/core/tabs/tabs.css          | 20 ++---
 src/pg/patterns/core/tooltip/index.pug      | 25 ++++--
 15 files changed, 227 insertions(+), 221 deletions(-)

diff --git a/public/patterns/core/breakpoints/index.html b/public/patterns/core/breakpoints/index.html
index 6d12e98..1906326 100644
--- a/public/patterns/core/breakpoints/index.html
+++ b/public/patterns/core/breakpoints/index.html
@@ -12,11 +12,17 @@
     <h2>How to use it</h2>
     <p>This pattern is only available for SCSS breakpoints. The  mixin is avai</p>
     <p>When using this, use the default break points as they are set to the same as the Bootstrap framework. The grid for the design system at large break point has been widened to accompdate 3 colour cards across. </p>
-    <div class="tab-group" id="breakpoints">
-      <pre class="language-css" data-tab="scss">//-		DS2 core (c) 2024 Alexander McIlwraith 
+    <tabset id="breakpoints">
+      <div tab="scss">
+        <pre class="language-sass">@import "[path-to]/breakpoints";
+@include break([breakpoint]) {
+	// css here
+}</pre>
+        <pre class="language-sass">//-		DS2 core (c) 2024 Alexander McIlwraith 
 //-		Licensed under CC BY-SA 4.0 
 
-$grid-breakpoints: ( xs: 0, sm: 576px, md: 768px, lg: 992px, xl: 1200px ) !default;
+// default breakpoints match bootstrap 5 breakpoints.
+$grid-breakpoints: ( xs: 0, sm: 576px, md: 768px, lg: 992px, xl: 1200px, xxl: 1400px ) !default;
 
 @mixin breakpoint-debug {
 	body::before, body::after {
@@ -99,6 +105,7 @@ $grid-breakpoints: ( xs: 0, sm: 576px, md: 768px, lg: 992px, xl: 1200px ) !defau
 		}
 	}
 }</pre>
-    </div>
+      </div>
+    </tabset>
   </body>
 </html>
\ No newline at end of file
diff --git a/public/patterns/core/header/index.html b/public/patterns/core/header/index.html
index ba020ac..ee11bbe 100644
--- a/public/patterns/core/header/index.html
+++ b/public/patterns/core/header/index.html
@@ -9,7 +9,9 @@
     <h2>When to use it</h2>
     <p>Use a header at the top of every page. The 'front page' of a site may have a different header than the rest of the pages. </p>
     <h2>How to use it</h2>
-    <p>Place the header at the top of the page after the skip to main content link. This basic header should be replaced with your own site's header. </p>
+    <p>Place the header at the top of the page after the skip to main content link. You will likely want to replace core header should be replaced with your own site's header. To do this, remove the 
+      <pre class="inline language-js">core: true </pre> and create your own pattern in the location you wish it in your design system. 
+    </p>
     <div class="tab-group" id="header">
       <pre class="language-html" data-tab="html">
         <!-- create temp variables and store the design system values-->
@@ -55,59 +57,7 @@ header
 				a(href="./")= site
 		// Other sections can go here, such as search and directory
 </pre>
-      <pre class="language-css" data-tab="css">header {
-	display: -ms-grid;
-	display: grid;
-	-ms-grid-rows: 1.75rem 3.5rem;
-	grid-template-rows: 1.75rem 3.5rem;
-	-ms-grid-column: 2;
-	-ms-grid-column-span: 2;
-	grid-column: 2/4;
-	overflow: hidden;
-}
-header svg {
-	grid-column: 1/-1;
-	grid-row: 1/-1;
-	-ms-grid-row-align: stretch;
-	-ms-grid-column-align: stretch;
-	place-self: stretch;
-}
-header svg text {
-	-webkit-transform: translate(-1rem, 7.25rem);
-	    -ms-transform: translate(-1rem, 7.25rem);
-	        transform: translate(-1rem, 7.25rem);
-	font-size: 10rem;
-	font-weight: 1000;
-	font-family: sans-serif;
-	fill: var(--colour-grey-xxl);
-}
-header > div {
-	-ms-grid-row: 2;
-	grid-row: 2;
-	grid-column: 1/-1;
-	display: -ms-grid;
-	display: grid;
-	grid-column-gap: 1rem;
-	-ms-grid-columns: auto -webkit-max-content -webkit-max-content;
-	-ms-grid-columns: auto max-content max-content;
-	grid-template-columns: auto -webkit-max-content -webkit-max-content;
-	grid-template-columns: auto max-content max-content;
-}
-header > div .header-title h1 {
-	margin: 0;
-	padding: 0 1rem;
-}
-header > div .header-title h1 a, header > div .header-title h1 a:visited {
-	border-bottom: none;
-	color: var(--colour-black);
-	font-family: sans-serif;
-	font-size: 2.5rem;
-	font-size: 32px;
-	font-weight: 700;
-	margin: 0;
-	padding: 0;
-	text-decoration: none;
-}</pre>
+      <pre class="language-css" data-tab="css">header{display:-ms-grid;display:grid;-ms-grid-rows:1.75rem 3.5rem;grid-template-rows:1.75rem 3.5rem;-ms-grid-column:2;-ms-grid-column-span:2;grid-column:2/4;overflow:hidden}header svg{grid-column:1/-1;grid-row:1/-1;-ms-grid-row-align:stretch;-ms-grid-column-align:stretch;place-self:stretch}header svg text{-webkit-transform:translate(-1rem,7.25rem);-ms-transform:translate(-1rem,7.25rem);transform:translate(-1rem,7.25rem);font-size:10rem;font-weight:1000;font-family:sans-serif;fill:var(--colour-grey-xxl)}header>div{-ms-grid-row:2;grid-row:2;grid-column:1/-1;display:-ms-grid;display:grid;grid-column-gap:1rem;-ms-grid-columns:auto -webkit-max-content -webkit-max-content;-ms-grid-columns:auto max-content max-content;grid-template-columns:auto -webkit-max-content -webkit-max-content;grid-template-columns:auto max-content max-content}header>div .header-title h1{margin:0;padding:0 1rem}header>div .header-title h1 a,header>div .header-title h1 a:visited{border-bottom:none;color:var(--colour-black);font-family:sans-serif;font-size:2.5rem;font-size:32px;font-weight:700;margin:0;padding:0;text-decoration:none}</pre>
       <pre class="language-sass" data-tab="scss">//-		DS2 core (c) 2024 Alexander McIlwraith 
 //-		Licensed under CC BY-SA 4.0 
 
diff --git a/public/patterns/core/sticky-note/index.html b/public/patterns/core/sticky-note/index.html
index 0b1ffe0..4966fa4 100644
--- a/public/patterns/core/sticky-note/index.html
+++ b/public/patterns/core/sticky-note/index.html
@@ -9,11 +9,11 @@
     <h2>When to use it</h2>
     <p>Use a sticky when you want to make a note without adding it to the content. </p>
     <h2>How to use it</h2>
-    <p>Uses absolute positioning. 
-      <sticky-note class="blue" float="right">This <strong>is</strong> a sample sticky. You can drag it out of the way if you need to see the content under it.</sticky-note>
+    <p>Uses absolute positioning. Passing an optional element to the init function will initialise tabs within that element. You can move the position using either <code class="language-html inline">float="[ right | left &#93;"</code> or <code class="language-html inline">offset="[ top | left &#93;"</code>. Offset will take negative values in any web measurement unit.
+      <sticky-note class="blue" offset="-10rem 1rem">This <strong>is</strong> a sample sticky. You can drag it out of the way if you need to see the content under it.</sticky-note>
+      <sticky-note float="right">You will notice when you hover over the sticky, it shows a dot in the colour of the sticky in the position where the sticky note refers to (assuming you haven't dragged it and scrolled that location off the screen).</sticky-note>
     </p>
     <p>If you wish to create a custom element, that extends another HTML element, the native element has to be extended in customElements.define(). Custom elements that inherit native elements are also known as "type extension custom elements". 	</p>
-    <sticky-note>You will notice when you hover over the sticky, it shows a dot in the colour of the sticky in the position where the sticky note refers to (assuming you haven't dragged it and scrolled that location off the screen).</sticky-note>
     <tabset id="sticky-note">
       <pre class="language-html" tab="html">
         <sticky-note class="blue" float="right">This <strong>is</strong> a sample sticky. You can drag it out of the way if you need to see the content under it.</sticky-note></pre>
@@ -145,7 +145,11 @@ sticky-note-wrapper:has(sticky-note.pink:hover) {
 sticky-note-wrapper:has(sticky-note.green:hover) {
 	background-color: #bbfbc0;
 }</pre>
-      <pre class="language-css" data-tab="scss"> //-		DS2 core (c) 2024 Alexander McIlwraith 
+      <div tab="scss"> 
+        <pre class="language-sass">$sticky-colors: ( [sass map with your own defined colours] );
+@import "[path to]/_sticky-note";
+@include sticky-note;</pre>
+        <pre class="language-sass">//-		DS2 core (c) 2024 Alexander McIlwraith 
 //-		Licensed under CC BY-SA 4.0 
 
 @use 'sass:color';
@@ -297,7 +301,12 @@ $sticky-colors: (
 		}
 	}
 }</pre>
-      <pre class="language-js" data-tab="js"> //-		DS2 core (c) 2024 Alexander McIlwraith 
+      </div>
+      <div tab="js"> 
+        <pre class="language-js">import * as stickynote from "[path to]]/_sticky-note.js";
+stickynote.init()
+</pre>
+        <pre class="language-js">//-		DS2 core (c) 2024 Alexander McIlwraith 
 //-		Licensed under CC BY-SA 4.0 
 
 const font = {
@@ -428,6 +437,7 @@ export function init(p = document){
 		});
 	}
 }</pre>
+      </div>
     </tabset>
   </body>
 </html>
\ No newline at end of file
diff --git a/public/patterns/core/switch/index.html b/public/patterns/core/switch/index.html
index 2ef0f53..851e4b1 100644
--- a/public/patterns/core/switch/index.html
+++ b/public/patterns/core/switch/index.html
@@ -16,13 +16,13 @@
       <label for="example-switch">Switch label (states the on state)</label><span id="example-switch" role="switch"></span>
     </p>
     <div class="tab-group" id="switches">
-      <pre class="language-html" data-tab="html"><span id="example-id" role="switch"></span></pre>
-      <pre class="language-pug" data-tab="pug">span#example-id(role="switch")</pre>
-      <pre class="language-css" data-tab="css">[role=switch] {
+      <pre class="language-html" tab="html"><span id="example-id" role="switch"></span></pre>
+      <pre class="language-pug" tab="pug">span#example-id(role="switch")</pre>
+      <pre class="language-css" tab="css">[role=switch] {
 	display: -ms-inline-grid;
 	display: inline-grid;
-	border: 1px solid var(--colour-blue);
-	background-color: var(--colour-grey-xl);
+	border: 1px solid #2e51a1;
+	background-color: #d8d8d8;
 	border-radius: 0.75rem;
 	height: 1.5rem;
 	width: 3rem;
@@ -39,12 +39,16 @@
 	transition: all 500ms;
 }
 [role=switch][aria-checked=true] {
-	background-color: var(--colour-blue);
+	background-color: #2e51a1;
 }
 [role=switch][aria-checked=true] > span {
 	margin-left: calc(1.5rem - 5%);
 }</pre>
-      <pre class="language-css" data-tab="scss">//-		DS2 core (c) 2024 Alexander McIlwraith 
+      <div tab="scss">
+        <pre class="language-sass">@import "[path to]/_switch"; 
+@include switch;
+</pre>
+        <pre class="language-sass">//-		DS2 core (c) 2024 Alexander McIlwraith 
 //-		Licensed under CC BY-SA 4.0 
 
 @use "sass:math";
@@ -80,7 +84,13 @@ $switch-height: 1.5rem !default;
 		}
 	}
 }</pre>
-      <pre class="language-js" data-tab="js">//-		DS2 core (c) 2024 Alexander McIlwraith 
+      </div>
+      <div tab="js">
+        <pre class="language-js">// Note that switch is a reserved word. 
+import * as swtch from "[path to]]/_switch.js";
+swtch.init();
+</pre>
+        <pre class="language-js">//-		DS2 core (c) 2024 Alexander McIlwraith 
 //-		Licensed under CC BY-SA 4.0 
 
 function flip(e) {
@@ -107,6 +117,7 @@ module.exports = {
 	}
 }
 </pre>
+      </div>
     </div>
   </body>
 </html>
\ No newline at end of file
diff --git a/public/patterns/core/tabs/index.html b/public/patterns/core/tabs/index.html
index f1aff57..dbe01aa 100644
--- a/public/patterns/core/tabs/index.html
+++ b/public/patterns/core/tabs/index.html
@@ -6,7 +6,7 @@
   <body data-prismjs-copy-timeout="1500">
     <h2>What is it</h2>
     <p>A tabs component that provides different sections of content that are displayed one at a time when the user selects that information. </p>
-    <h2>How to use it</h2>
+    <h2>When to use it</h2>
     <p>The tabbed user interface enables users to jump to their target section quickly. Tabs present like logically group information on the same page. Information should  </p>
     <ul> 
       <li>be logically chunked and ordered</li>
@@ -15,8 +15,8 @@
       <li>obvious where they begin and end </li>
     </ul>
     <p>Users should not need to see content of multiple tabs simultaneously and the user should be able to easily recognise where they are within the content.  </p>
-    <h2>When to use it</h2>
-    <p>The tab module can be initialised by importing a file with the javascript module using import * as tabs from "../pg/patterns/layouts/tabs/_tabs.js"; contains a modularized version of the jQuery code, so that it can be called on demand. It is what is used in the design system so that the JavaScript can be called at run time (after loading content).</p>
+    <h2>How to use it</h2>
+    <p>The structure of the tab set is defined in html. There are two forms supported. Adding a class of <code class="inline">.tab-group</code> to the container element will work in place of the <code class="inline">tabset</code> tag, and the tab panels can be defined using either <code class="inline">tab=""</code> or <code class="inline">data-tab=""</code>. Passing an optional element to the init function will initialise tabs within that element. </p>
     <tabset id="tabs">
       <pre class="language-html" tab="html">
         <tabset id="uniqueID">
@@ -38,8 +38,8 @@ tabset > ul, .tab-group > ul {
 	padding: 0;
 }
 tabset > ul li.separator, .tab-group > ul li.separator {
-	border-bottom: 1px solid var(--colour-grey);
-	border-left: 1px solid var(--colour-grey);
+	border-bottom: 1px solid #7f7f7f;
+	border-left: 1px solid #7f7f7f;
 	display: inline-block;
 	margin: 0.45rem 0 0 0;
 	width: 100%;
@@ -48,9 +48,9 @@ tabset .tab-hidden, .tab-group .tab-hidden {
 	display: none;
 }
 tabset [role=tab], .tab-group [role=tab] {
-	background-color: var(--colour-white);
-	border-left: 1px solid var(--colour-grey);
-	border-top: 1px solid var(--colour-grey);
+	background-color: #FFF;
+	border-left: 1px solid #7f7f7f;
+	border-top: 1px solid #7f7f7f;
 	border-radius: 0.5rem 0.5rem 0 0;
 	cursor: pointer;
 	margin: 0;
@@ -59,19 +59,19 @@ tabset [role=tab], .tab-group [role=tab] {
 	z-index: 2;
 }
 tabset [role=tab]:last-of-type, .tab-group [role=tab]:last-of-type {
-	border-right: 1px solid var(--colour-grey);
+	border-right: 1px solid #7f7f7f;
 }
 tabset [role=tab]:not(.selected), .tab-group [role=tab]:not(.selected) {
-	background-color: var(--colour-grey-xxl);
-	border-bottom: 1px solid var(--colour-grey);
+	background-color: #f0f0f0;
+	border-bottom: 1px solid #7f7f7f;
 }
 tabset [role=tab] span, .tab-group [role=tab] span {
 	display: block;
 	margin: 0 0 0.5rem 0;
 }
 tabset [role=tabpanel], .tab-group [role=tabpanel] {
-	background-color: var(--colour-white);
-	border: 1px solid var(--colour-grey);
+	background-color: #FFF;
+	border: 1px solid #7f7f7f;
 	border-top: none;
 	padding: 1rem;
 	z-index: 1;
@@ -79,7 +79,13 @@ tabset [role=tabpanel], .tab-group [role=tabpanel] {
 tabset [role=tabpanel]:not(.open), .tab-group [role=tabpanel]:not(.open) {
 	display: none;
 }</pre>
-      <pre class="language-css" tab="scss">//		DS2 core (c) 2024 Alexander McIlwraith 
+      <div tab="scss">
+        <pre class="language-sass">@import "[path to]/_tabs";
+@include tabs{ 
+	// optional content block
+};
+</pre>
+        <pre class="language-sass">//		DS2 core (c) 2024 Alexander McIlwraith 
 //		Licensed under CC BY-SA 4.0 
 
 $tab-border: #7f7f7f !default; 
@@ -148,7 +154,11 @@ $tab-notselected: #f0f0f0 !default;
 		}
 	}
 }</pre>
-      <pre class="language-css" tab="js">/*  DS2 core (c) 2024 Alexander McIlwraith 
+      </div>
+      <div tab="js">
+        <pre class="language-js">import * as tabs from "[path to]/_tabs.js";
+tabs.init();</pre>
+        <pre class="language-js">/*  DS2 core (c) 2024 Alexander McIlwraith 
 	import * as tabs from "../pg/patterns/layouts/tabs/_tabs.js";
 	tabs.init();
  */
@@ -202,6 +212,7 @@ export function init(p = document) {
 	});
 }
 </pre>
+      </div>
     </tabset>
   </body>
 </html>
\ No newline at end of file
diff --git a/public/patterns/core/tooltip/index.html b/public/patterns/core/tooltip/index.html
index eaa3f2c..402ddc3 100644
--- a/public/patterns/core/tooltip/index.html
+++ b/public/patterns/core/tooltip/index.html
@@ -11,7 +11,9 @@
     <p>Use tooltips to help differentiate between multiple, close, similar options. </p>
     <h2>How to use it</h2>
     <p class="notification-box info">Currently, there is no easy way to activate a hover without with pure CSS without using a keyboard or mouse. Level4 media queries aim to solve that.</p>
-    <p>Either form works. Place this inside another element for the tooltip to be 'linked to that element.' A container element may need to be added for a single tag element, such as a input field. </p>
+    <p>Either form works. 
+      <sticky-note class="blue">"Either form works": What are the two forms.</sticky-note>Place the <code class="language-html inline">tooltip</code> inside another element for the tooltip to be 'linked to that element.' A container element may need to be added for a single tag element, such as a input field. 
+    </p>
     <p>Tool tip positions are: </p>
     <ul> 
       <li>top / block-start</li>
@@ -20,11 +22,11 @@
       <li>left / inline-start</li>
     </ul>
     <p><a href="#">Link with a tool tip<span role="tooltip" inert="inert" tip-position="right">Tool tip content</span></a></p>
-    <div class="tab-group" id="tooltip">
-      <pre class="language-html" data-tab="html"><a href="#">Link with a tool tip<span role="tooltip" inert="inert" tip-position="right">Tool tip content</span></a></pre>
-      <pre class="language-pug" data-tab="pug">a(href="#") Link with a tool tip
+    <tabset id="tooltip">
+      <pre class="language-html" tab="html"><a href="#">Link with a tool tip<span role="tooltip" inert="inert" tip-position="right">Tool tip content</span></a></pre>
+      <pre class="language-pug" tab="pug">a(href="#") Link with a tool tip
 	span(role="tooltip" inert tip-position="right") Tool tip content</pre>
-      <pre class="language-css" data-tab="css">/* Position Options
+      <pre class="language-css" tab="css">/* Position Options
 	- top / block-start
 	- right / inline-end
 	- bottom / block-end
@@ -179,7 +181,10 @@
 		--tooltip-x: calc(-1 * 3px * -1);
 	}
 }</pre>
-      <pre class="language-css" data-tab="scss">//-		DS2 core (c) 2024 Alexander McIlwraith 
+      <div tab="scss">
+        <pre class="language-sass">@import "[path to]/_tooltip";
+@include tooltip;</pre>
+        <pre class="language-sass">//-		DS2 core (c) 2024 Alexander McIlwraith 
 //-		Licensed under CC BY-SA 4.0 
 
 $tooltip-border-radius: .5rem !default;
@@ -356,6 +361,7 @@ $tooltip-pointer-top: conic-gradient(from 150deg at top, rgba(0, 0, 0, 0), #000
 
 	}
 }</pre>
-    </div>
+      </div>
+    </tabset>
   </body>
 </html>
\ No newline at end of file
diff --git a/src/pg/patterns/core/breakpoints/index.pug b/src/pg/patterns/core/breakpoints/index.pug
index 00fbb43..c9e708b 100644
--- a/src/pg/patterns/core/breakpoints/index.pug
+++ b/src/pg/patterns/core/breakpoints/index.pug
@@ -17,6 +17,14 @@ block content
 
 	p When using this, use the default break points as they are set to the same as the Bootstrap framework. The grid for the design system at large break point has been widened to accompdate 3 colour cards across. 
 
-	div.tab-group#breakpoints
-		pre.language-css(data-tab="scss")
-			include _breakpoints.scss
\ No newline at end of file
+	tabset#breakpoints
+		div(tab="scss")
+			+h(3)
+			pre.language-sass.
+				@import "[path-to]/breakpoints";
+				@include break([breakpoint]) {
+					// css here
+				}
+			+h(4)
+			pre.language-sass
+				include _breakpoints.scss
\ No newline at end of file
diff --git a/src/pg/patterns/core/header/header.css b/src/pg/patterns/core/header/header.css
index 2b5ebc0..f1164e4 100644
--- a/src/pg/patterns/core/header/header.css
+++ b/src/pg/patterns/core/header/header.css
@@ -1,53 +1 @@
-header {
-	display: -ms-grid;
-	display: grid;
-	-ms-grid-rows: 1.75rem 3.5rem;
-	grid-template-rows: 1.75rem 3.5rem;
-	-ms-grid-column: 2;
-	-ms-grid-column-span: 2;
-	grid-column: 2/4;
-	overflow: hidden;
-}
-header svg {
-	grid-column: 1/-1;
-	grid-row: 1/-1;
-	-ms-grid-row-align: stretch;
-	-ms-grid-column-align: stretch;
-	place-self: stretch;
-}
-header svg text {
-	-webkit-transform: translate(-1rem, 7.25rem);
-	    -ms-transform: translate(-1rem, 7.25rem);
-	        transform: translate(-1rem, 7.25rem);
-	font-size: 10rem;
-	font-weight: 1000;
-	font-family: sans-serif;
-	fill: var(--colour-grey-xxl);
-}
-header > div {
-	-ms-grid-row: 2;
-	grid-row: 2;
-	grid-column: 1/-1;
-	display: -ms-grid;
-	display: grid;
-	grid-column-gap: 1rem;
-	-ms-grid-columns: auto -webkit-max-content -webkit-max-content;
-	-ms-grid-columns: auto max-content max-content;
-	grid-template-columns: auto -webkit-max-content -webkit-max-content;
-	grid-template-columns: auto max-content max-content;
-}
-header > div .header-title h1 {
-	margin: 0;
-	padding: 0 1rem;
-}
-header > div .header-title h1 a, header > div .header-title h1 a:visited {
-	border-bottom: none;
-	color: var(--colour-black);
-	font-family: sans-serif;
-	font-size: 2.5rem;
-	font-size: 32px;
-	font-weight: 700;
-	margin: 0;
-	padding: 0;
-	text-decoration: none;
-}
\ No newline at end of file
+header{display:-ms-grid;display:grid;-ms-grid-rows:1.75rem 3.5rem;grid-template-rows:1.75rem 3.5rem;-ms-grid-column:2;-ms-grid-column-span:2;grid-column:2/4;overflow:hidden}header svg{grid-column:1/-1;grid-row:1/-1;-ms-grid-row-align:stretch;-ms-grid-column-align:stretch;place-self:stretch}header svg text{-webkit-transform:translate(-1rem,7.25rem);-ms-transform:translate(-1rem,7.25rem);transform:translate(-1rem,7.25rem);font-size:10rem;font-weight:1000;font-family:sans-serif;fill:var(--colour-grey-xxl)}header>div{-ms-grid-row:2;grid-row:2;grid-column:1/-1;display:-ms-grid;display:grid;grid-column-gap:1rem;-ms-grid-columns:auto -webkit-max-content -webkit-max-content;-ms-grid-columns:auto max-content max-content;grid-template-columns:auto -webkit-max-content -webkit-max-content;grid-template-columns:auto max-content max-content}header>div .header-title h1{margin:0;padding:0 1rem}header>div .header-title h1 a,header>div .header-title h1 a:visited{border-bottom:none;color:var(--colour-black);font-family:sans-serif;font-size:2.5rem;font-size:32px;font-weight:700;margin:0;padding:0;text-decoration:none}
\ No newline at end of file
diff --git a/src/pg/patterns/core/header/index.pug b/src/pg/patterns/core/header/index.pug
index 967bb85..b4269a7 100644
--- a/src/pg/patterns/core/header/index.pug
+++ b/src/pg/patterns/core/header/index.pug
@@ -10,8 +10,7 @@ block content
 	p Use a header at the top of every page. The 'front page' of a site may have a different header than the rest of the pages. 
 
 	+h(2)
-	p Place the header at the top of the page after the skip to main content link. This basic header should be replaced with your own site's header. 
-
+	p Place the header at the top of the page after the skip to main content link. You will likely want to replace core header should be replaced with your own site's header. To do this, remove the #[pre.inline.language-js core: true ] and create your own pattern in the location you wish it in your design system. 
 
 	div.tab-group#header
 		pre.language-html(data-tab="html")
diff --git a/src/pg/patterns/core/sticky-note/index.pug b/src/pg/patterns/core/sticky-note/index.pug
index b46918e..93c3e66 100644
--- a/src/pg/patterns/core/sticky-note/index.pug
+++ b/src/pg/patterns/core/sticky-note/index.pug
@@ -8,13 +8,13 @@ block content
 	+h(1)
 	p Use a sticky when you want to make a note without adding it to the content. 
 	+h(2)
-	p Uses absolute positioning. 
-		sticky-note(float="right").blue This #[strong is] a sample sticky. 
+	p Uses absolute positioning. Passing an optional element to the init function will initialise tabs within that element. You can move the position using either #[code.language-html.inline float="[ right | left &#93;"] or #[code.language-html.inline offset="[ top | left &#93;"]. Offset will take negative values in any web measurement unit.
+		sticky-note.blue(offset="-10rem 1rem") This #[strong is] a sample sticky. 
 			| You can drag it out of the way if you need to see the content under it.
+		sticky-note(float="right") You will notice when you hover over the sticky, it shows a dot in the colour of the sticky in the position where the sticky note refers to (assuming you haven't dragged it and scrolled that location off the screen).
 
 	p If you wish to create a custom element, that extends another HTML element, the native element has to be extended in customElements.define(). Custom elements that inherit native elements are also known as "type extension custom elements". 	
 
-	sticky-note You will notice when you hover over the sticky, it shows a dot in the colour of the sticky in the position where the sticky note refers to (assuming you haven't dragged it and scrolled that location off the screen).
 
 	tabset#sticky-note
 		pre.language-html(tab="html")
@@ -23,7 +23,21 @@ block content
 			include _sticky-note.pp
 		pre.language-css(data-tab="css") 
 			include sticky-note.css
-		pre.language-css(data-tab="scss") 
-			include _sticky-note.scss
-		pre.language-js(data-tab="js") 
-			include _sticky-note.js
\ No newline at end of file
+		div(tab="scss") 
+			+h(3)
+			pre.language-sass.
+				$sticky-colors: ( [sass map with your own defined colours] );
+				@import "[path to]/_sticky-note";
+				@include sticky-note;
+			+h(4)
+			pre.language-sass
+				include _sticky-note.scss
+		div(tab="js") 
+			+h(3)
+			pre.language-js.
+				import * as stickynote from "[path to]]/_sticky-note.js";
+				stickynote.init()
+
+			+h(4)
+			pre.language-js
+				include _sticky-note.js
\ No newline at end of file
diff --git a/src/pg/patterns/core/switch/index.pug b/src/pg/patterns/core/switch/index.pug
index 71e14d2..dd9cd82 100644
--- a/src/pg/patterns/core/switch/index.pug
+++ b/src/pg/patterns/core/switch/index.pug
@@ -21,13 +21,28 @@ block content
 		span#example-switch(role="switch")
 
 	div#switches.tab-group
-		pre.language-html(data-tab="html")
+		pre.language-html(tab="html")
 			include _switch.pug
-		pre.language-pug(data-tab="pug")
+		pre.language-pug(tab="pug")
 			include _switch.pp
-		pre.language-css(data-tab="css")
+		pre.language-css(tab="css")
 			include switch.css
-		pre.language-css(data-tab="scss")
-			include _switch.scss
-		pre.language-js(data-tab="js")
-			include _switch.js
+		div(tab="scss")
+			+h(3)
+			pre.language-sass.
+				@import "[path to]/_switch"; 
+				@include switch;
+				
+			+h(4)
+			pre.language-sass
+				include _switch.scss
+		div(tab="js")
+			+h(3)
+			pre.language-js.
+				// Note that switch is a reserved word. 
+				import * as swtch from "[path to]]/_switch.js";
+				swtch.init();
+
+			+h(4)
+			pre.language-js
+				include _switch.js
diff --git a/src/pg/patterns/core/switch/switch.css b/src/pg/patterns/core/switch/switch.css
index 946a2b8..f71e867 100644
--- a/src/pg/patterns/core/switch/switch.css
+++ b/src/pg/patterns/core/switch/switch.css
@@ -1,8 +1,8 @@
 [role=switch] {
 	display: -ms-inline-grid;
 	display: inline-grid;
-	border: 1px solid var(--colour-blue);
-	background-color: var(--colour-grey-xl);
+	border: 1px solid #2e51a1;
+	background-color: #d8d8d8;
 	border-radius: 0.75rem;
 	height: 1.5rem;
 	width: 3rem;
@@ -19,7 +19,7 @@
 	transition: all 500ms;
 }
 [role=switch][aria-checked=true] {
-	background-color: var(--colour-blue);
+	background-color: #2e51a1;
 }
 [role=switch][aria-checked=true] > span {
 	margin-left: calc(1.5rem - 5%);
diff --git a/src/pg/patterns/core/tabs/index.pug b/src/pg/patterns/core/tabs/index.pug
index 1a957ba..3e4f8fc 100644
--- a/src/pg/patterns/core/tabs/index.pug
+++ b/src/pg/patterns/core/tabs/index.pug
@@ -1,36 +1,52 @@
-//-		DS2 core (c) 2024 Alexander McIlwraith 
-//-		Core licensed under CC BY-SA 4.0 
-
-extends ../../../core/_master-pattern
-block content
-
-	+h(0)
-	p A tabs component that provides different sections of content that are displayed one at a time when the user selects that information. 
-
-	+h(2)
-	p The tabbed user interface enables users to jump to their target section quickly. Tabs present like logically group information on the same page. Information should  
-
-	ul 
-		li be logically chunked and ordered
-		li be parallel in nature
-		li show user's context
-		li obvious where they begin and end 
-
-	p Users should not need to see content of multiple tabs simultaneously and the user should be able to easily recognise where they are within the content.  
-
-
-	+h(1)
-	p The tab module can be initialised by importing a file with the javascript module using import * as tabs from "../pg/patterns/layouts/tabs/_tabs.js"; contains a modularized version of the jQuery code, so that it can be called on demand. It is what is used in the design system so that the JavaScript can be called at run time (after loading content).
-
-	tabset#tabs
-		pre.language-html(tab="html")
-			include _tabs.pug
-		pre.language-pug(tab="pug")
-			include _tabs.pp
-		pre.language-css(tab="css")
-			include tabs.css
-		pre.language-css(tab="scss")
-			include _tabs.scss
-		pre.language-css(tab="js")
-			include _tabs.js
-
+//-		DS2 core (c) 2024 Alexander McIlwraith 
+//-		Core licensed under CC BY-SA 4.0 
+
+extends ../../../core/_master-pattern
+block content
+
+	+h(0)
+	p A tabs component that provides different sections of content that are displayed one at a time when the user selects that information. 
+
+	+h(1)
+	p The tabbed user interface enables users to jump to their target section quickly. Tabs present like logically group information on the same page. Information should  
+
+	ul 
+		li be logically chunked and ordered
+		li be arallel in nature
+		li show user's context
+		li obvious where they begin and end 
+
+	p Users should not need to see content of multiple tabs simultaneously and the user should be able to easily recognise where they are within the content.  
+
+
+	+h(2)
+	p The structure of the tab set is defined in html. There are two forms supported. Adding a class of #[code.inline .tab-group] to the container element will work in place of the #[code.inline tabset] tag, and the tab panels can be defined using either #[code.inline tab=""] or #[code.inline data-tab=""]. Passing an optional element to the init function will initialise tabs within that element. 
+
+
+	tabset#tabs
+		pre.language-html(tab="html")
+			include _tabs.pug
+		pre.language-pug(tab="pug")
+			include _tabs.pp
+		pre.language-css(tab="css")
+			include tabs.css
+		div(tab="scss")
+			+h(3)
+			pre.language-sass.
+				@import "[path to]/_tabs";
+				@include tabs{ 
+					// optional content block
+				};
+
+			+h(4)
+			pre.language-sass
+				include _tabs.scss
+		div(tab="js")
+			+h(3)
+			pre.language-js.
+				import * as tabs from "[path to]/_tabs.js";
+				tabs.init();
+			+h(4)
+			pre.language-js
+				include _tabs.js
+
diff --git a/src/pg/patterns/core/tabs/tabs.css b/src/pg/patterns/core/tabs/tabs.css
index 133cb1c..660483f 100644
--- a/src/pg/patterns/core/tabs/tabs.css
+++ b/src/pg/patterns/core/tabs/tabs.css
@@ -9,8 +9,8 @@ tabset > ul, .tab-group > ul {
 	padding: 0;
 }
 tabset > ul li.separator, .tab-group > ul li.separator {
-	border-bottom: 1px solid var(--colour-grey);
-	border-left: 1px solid var(--colour-grey);
+	border-bottom: 1px solid #7f7f7f;
+	border-left: 1px solid #7f7f7f;
 	display: inline-block;
 	margin: 0.45rem 0 0 0;
 	width: 100%;
@@ -19,9 +19,9 @@ tabset .tab-hidden, .tab-group .tab-hidden {
 	display: none;
 }
 tabset [role=tab], .tab-group [role=tab] {
-	background-color: var(--colour-white);
-	border-left: 1px solid var(--colour-grey);
-	border-top: 1px solid var(--colour-grey);
+	background-color: #FFF;
+	border-left: 1px solid #7f7f7f;
+	border-top: 1px solid #7f7f7f;
 	border-radius: 0.5rem 0.5rem 0 0;
 	cursor: pointer;
 	margin: 0;
@@ -30,19 +30,19 @@ tabset [role=tab], .tab-group [role=tab] {
 	z-index: 2;
 }
 tabset [role=tab]:last-of-type, .tab-group [role=tab]:last-of-type {
-	border-right: 1px solid var(--colour-grey);
+	border-right: 1px solid #7f7f7f;
 }
 tabset [role=tab]:not(.selected), .tab-group [role=tab]:not(.selected) {
-	background-color: var(--colour-grey-xxl);
-	border-bottom: 1px solid var(--colour-grey);
+	background-color: #f0f0f0;
+	border-bottom: 1px solid #7f7f7f;
 }
 tabset [role=tab] span, .tab-group [role=tab] span {
 	display: block;
 	margin: 0 0 0.5rem 0;
 }
 tabset [role=tabpanel], .tab-group [role=tabpanel] {
-	background-color: var(--colour-white);
-	border: 1px solid var(--colour-grey);
+	background-color: #FFF;
+	border: 1px solid #7f7f7f;
 	border-top: none;
 	padding: 1rem;
 	z-index: 1;
diff --git a/src/pg/patterns/core/tooltip/index.pug b/src/pg/patterns/core/tooltip/index.pug
index 9067cb0..0bc9610 100644
--- a/src/pg/patterns/core/tooltip/index.pug
+++ b/src/pg/patterns/core/tooltip/index.pug
@@ -6,6 +6,7 @@ block content
 
 	+h(0)
 	p Tooltips provide brief information messaging through a mouse or keyboard hover. 
+
 	+h(1)
 	p Use tool tips to provide additional information. Don't use tooltips for that is required to complete an interaction as the information disappears when it loses the hover state. 
 	
@@ -15,7 +16,11 @@ block content
 
 	p.notification-box.info Currently, there is no easy way to activate a hover without with pure CSS without using a keyboard or mouse. Level4 media queries aim to solve that.
 
-	p Either form works. Place this inside another element for the tooltip to be 'linked to that element.' A container element may need to be added for a single tag element, such as a input field. 
+	
+
+	p Either form works. 
+		sticky-note.blue "Either form works": What are the two forms.
+		| Place the #[code.language-html.inline tooltip] inside another element for the tooltip to be 'linked to that element.' A container element may need to be added for a single tag element, such as a input field. 
 
 	p Tool tip positions are: 
 	ul 
@@ -28,13 +33,19 @@ block content
 		include _tooltip.pug
 
 
-	div#tooltip.tab-group
-		pre.language-html(data-tab="html")
+	tabset#tooltip
+		pre.language-html(tab="html")
 			include _tooltip.pug
-		pre.language-pug(data-tab="pug")
+		pre.language-pug(tab="pug")
 			include _tooltip.pp
-		pre.language-css(data-tab="css")
+		pre.language-css(tab="css")
 			include tooltip.css
-		pre.language-css(data-tab="scss")
-			include _tooltip.scss
+		div(tab="scss")
+			+h(3)
+			pre.language-sass.
+				@import "[path to]/_tooltip";
+				@include tooltip;
+			+h(4)
+			pre.language-sass
+				include _tooltip.scss