From 8b84fa6b505b29f568164551d85944ba8e2db7c2 Mon Sep 17 00:00:00 2001
From: Ryan <fauxpark@gmail.com>
Date: Thu, 30 May 2024 19:09:07 +1000
Subject: [PATCH 1/2] [docs] Better logo SVG (#23828)

---
 builddefs/docsgen/.vitepress/config.mts       |  6 +++---
 builddefs/docsgen/.vitepress/theme/custom.css | 12 ------------
 docs/public/qmk-logo-dark.svg                 | 14 ++++++++++++++
 docs/public/qmk-logo-light.svg                | 14 ++++++++++++++
 4 files changed, 31 insertions(+), 15 deletions(-)
 create mode 100644 docs/public/qmk-logo-dark.svg
 create mode 100644 docs/public/qmk-logo-light.svg

diff --git a/builddefs/docsgen/.vitepress/config.mts b/builddefs/docsgen/.vitepress/config.mts
index f2111eeb7c..289e08ef91 100644
--- a/builddefs/docsgen/.vitepress/config.mts
+++ b/builddefs/docsgen/.vitepress/config.mts
@@ -28,10 +28,10 @@ export default defineConfig(({ mode }) => {
         themeConfig: {
             // https://vitepress.dev/reference/default-theme-config
             logo: {
-                light: "/badge-community-light.svg",
-                dark: "/badge-community-dark.svg",
+                light: "/qmk-logo-light.svg",
+                dark: "/qmk-logo-dark.svg",
             },
-            siteTitle: false,
+            title: 'QMK Firmware',
 
             nav: [{ text: "Home", link: "./" }],
 
diff --git a/builddefs/docsgen/.vitepress/theme/custom.css b/builddefs/docsgen/.vitepress/theme/custom.css
index 646d215c1f..77726adede 100644
--- a/builddefs/docsgen/.vitepress/theme/custom.css
+++ b/builddefs/docsgen/.vitepress/theme/custom.css
@@ -5,15 +5,3 @@ kbd {
     margin: 0.2em;
     padding: 0.2em;
 }
-
-:root {
-    --vp-nav-logo-height: 100%;
-}
-
-.logo {
-    padding-bottom: 0.2em;
-}
-
-.VPNavBarTitle.has-sidebar .title {
-    border-bottom: 0;
-}
diff --git a/docs/public/qmk-logo-dark.svg b/docs/public/qmk-logo-dark.svg
new file mode 100644
index 0000000000..b89e1de6c8
--- /dev/null
+++ b/docs/public/qmk-logo-dark.svg
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+   width="512"
+   height="512"
+   viewBox="0 0 512 512"
+   version="1.1"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg">
+  <g>
+    <path
+       d="m 144.64051,512.00019 h -14.11395 c -3.89372,0 -7.05696,-3.16104 -7.05696,-7.05698 v -45.36247 h -9.97673 c -33.707631,0 -61.07342,-27.3658 -61.07342,-61.07345 v -9.97671 H 7.0569772 C 3.161054,388.53058 0,385.36734 0,381.4736 v -14.11395 c 0,-3.89371 3.161054,-7.05695 7.0569772,-7.05695 H 52.41945 V 329.32176 H 7.0569772 C 3.161054,329.32176 0,326.16071 0,322.26479 v -14.11395 c 0,-3.89373 3.161054,-7.05698 7.0569772,-7.05698 H 52.41945 V 270.11294 H 7.0569772 C 3.161054,270.11294 0,266.95189 0,263.05816 v -14.11394 c 0,-3.89592 3.161054,-7.05698 7.0569772,-7.05698 H 52.41945 V 210.90632 H 7.0569772 C 3.161054,210.90632 0,207.74308 0,203.84934 V 189.7354 c 0,-3.89373 3.161054,-7.05698 7.0569772,-7.05698 H 52.41945 V 151.6975 H 7.0569772 C 3.161054,151.6975 0,148.53646 0,144.64053 v -14.11395 c 0,-3.89372 3.161054,-7.05478 7.0569772,-7.05697 H 52.41945 v -9.97672 c 0,-33.707636 27.365789,-61.073424 61.07342,-61.073424 h 9.97673 V 7.0569776 C 123.4696,3.1610543 126.63284,0 130.52656,0 h 14.11395 c 3.89592,0 7.05698,3.1610543 7.05698,7.0569776 V 52.419466 h 30.98092 V 7.0569776 C 182.67841,3.1610543 185.83946,0 189.73539,0 h 14.11394 c 3.89373,0 7.05698,3.1610543 7.05698,7.0569776 V 52.419466 h 30.98092 V 7.0569776 C 241.88723,3.1610543 245.04828,0 248.9442,0 h 14.11175 c 3.89593,0 7.05698,3.1610543 7.05698,7.0569776 V 52.419466 h 30.98092 V 7.0569776 C 301.09385,3.1610543 304.25709,0 308.15083,0 h 14.11394 c 3.89592,0 7.05697,3.1610543 7.05697,7.0569776 V 52.419466 H 360.3026 V 7.0569776 C 360.3026,3.1610543 363.46362,0 367.35954,0 h 14.11387 c 3.89374,0 7.05698,3.1610543 7.05698,7.0569776 V 52.419466 h 9.97671 c 33.70765,0 61.07345,27.365788 61.07345,61.073424 v 9.97672 h 45.36247 c 3.89594,0.002 7.05699,3.16325 7.05699,7.05697 v 14.11395 c 0,3.89373 -3.16105,7.05697 -7.05699,7.05697 h -45.36247 v 30.98092 h 45.36247 c 3.89594,0.002 7.05699,3.16325 7.05699,7.05698 v 14.11394 c 0,3.89374 -3.16105,7.05479 -7.05699,7.05698 h -45.36247 v 30.98092 h 45.36247 c 3.89594,0 7.05699,3.16324 7.05699,7.05698 v 14.11394 c 0,3.89373 -3.16105,7.05478 -7.05699,7.05478 h -45.36247 v 30.98092 h 45.36247 c 3.89594,0.002 7.05699,3.16325 7.05699,7.05698 v 14.11395 c 0,3.89372 -3.16105,7.05697 -7.05699,7.05697 h -45.36247 v 30.98094 h 45.36247 c 3.89594,0.002 7.05699,3.16324 7.05699,7.05695 v 14.11395 c 0,3.89374 -3.16105,7.05479 -7.05699,7.05698 h -45.36247 v 9.97671 c 0,33.70765 -27.3658,61.07345 -61.07345,61.07345 h -9.97671 v 45.36247 c 0,3.89594 -3.16104,7.05698 -7.05698,7.05698 h -14.11387 c -3.89592,0 -7.05694,-3.16104 -7.05694,-7.05698 v -45.36247 h -30.98086 v 45.36247 c 0,3.89594 -3.16105,7.05698 -7.05697,7.05698 h -14.11394 c -3.89374,0 -7.05698,-3.16104 -7.05698,-7.05698 v -45.36247 h -30.98092 v 45.36247 c 0,3.89594 -3.16105,7.05698 -7.05698,7.05698 H 248.9442 c -3.89592,0 -7.05697,-3.16104 -7.05697,-7.05698 v -45.36247 h -30.98092 v 45.36247 c 0,3.89594 -3.16106,7.05698 -7.05698,7.05698 h -14.11394 c -3.89373,0 -7.05698,-3.16104 -7.05698,-7.05698 v -45.36247 h -30.98092 v 45.36247 c 0,3.89594 -3.16106,7.05698 -7.05698,7.05698 z m 227.56916,-279.1486 c 0,14.8598 -2.32965,28.17745 -6.99111,39.95297 -4.6593,11.77551 -11.30163,21.81804 -19.92924,30.12978 -8.62543,8.31174 -19.07817,14.73475 -31.35823,19.26903 -12.27786,4.53427 -26.16367,6.98896 -41.65303,7.36847 v 45.14753 c 0,1.00687 -0.25229,1.88871 -0.7568,2.64552 -0.50235,0.75464 -1.38419,1.35351 -2.64335,1.79443 -1.25915,0.44088 -2.92852,0.78531 -5.00591,1.03759 -2.07739,0.25247 -4.69222,0.37946 -7.84011,0.37946 -3.14789,0 -5.76052,-0.12737 -7.8401,-0.37946 -2.07739,-0.25209 -3.71385,-0.59671 -4.91159,-1.03759 -1.19553,-0.44092 -2.07738,-1.03979 -2.64334,-1.79443 -0.56818,-0.75678 -0.85114,-1.63865 -0.85114,-2.64552 v -45.14753 c -15.74164,-0.37948 -29.78319,-2.64554 -42.12467,-6.80251 -12.34367,-4.15478 -22.79641,-10.16757 -31.35823,-18.04058 -8.56401,-7.87082 -15.11425,-17.53604 -19.64633,-28.99568 -4.53428,-11.45963 -6.80251,-24.62153 -6.80251,-39.48131 v -96.53159 c 0,-0.88184 0.2852,-1.70008 0.85113,-2.4547 0.56594,-0.75679 1.44781,-1.38638 2.64554,-1.88873 1.19554,-0.5045 2.83201,-0.88184 4.91159,-1.13411 2.07738,-0.25228 4.69003,-0.37731 7.83791,-0.37731 3.15008,0 5.76272,0.12503 7.84011,0.37731 2.07738,0.25228 3.74675,0.62962 5.00591,1.13411 1.25916,0.50235 2.141,1.13193 2.64554,1.88873 0.50235,0.75465 0.75464,1.57286 0.75464,2.4547 v 93.69739 c 0,10.45274 1.38639,19.86789 4.15697,28.24106 2.77058,8.37535 6.92535,15.49155 12.46651,21.3464 5.54116,5.85706 12.56304,10.39132 21.06344,13.60283 8.50039,3.20932 18.41788,4.9423 29.75247,5.19457 V 139.72017 c 0,-0.88184 0.28298,-1.70008 0.85114,-2.4547 0.56595,-0.75679 1.51142,-1.38638 2.83201,-1.88873 1.32276,-0.5045 3.02284,-0.88184 5.10242,-1.13411 2.07739,-0.25228 4.56499,-0.37731 7.46061,-0.37731 3.14788,0 5.76272,0.12503 7.8401,0.37731 2.0774,0.25228 3.74676,0.62962 5.00591,1.13411 1.25916,0.50235 2.14101,1.13193 2.64335,1.88873 0.50451,0.75465 0.7568,1.57286 0.7568,2.4547 v 162.08225 c 11.3346,-0.12726 21.21918,-1.85802 29.65816,-5.19457 8.43678,-3.33874 15.45865,-7.93444 21.06343,-13.79148 5.60258,-5.85485 9.82316,-12.90743 12.65516,-21.15775 2.8342,-8.24814 4.2513,-17.41101 4.2513,-27.48425 v -94.4542 c 0,-0.88184 0.25228,-1.70008 0.75464,-2.4547 0.50451,-0.75679 1.38639,-1.38638 2.64555,-1.88873 1.25915,-0.5045 2.89781,-0.88184 4.91158,-1.13411 2.01594,-0.25228 4.65928,-0.37731 7.93438,-0.37731 3.02285,0 5.57186,0.12503 7.65143,0.37731 2.07736,0.25228 3.71381,0.62962 4.91154,1.13411 1.19554,0.50235 2.07736,1.13193 2.64335,1.88873 0.56595,0.75465 0.85111,1.57286 0.85111,2.4547 z"
+       style="fill:rgb(255,255,245);fill-rule:evenodd" />
+  </g>
+</svg>
diff --git a/docs/public/qmk-logo-light.svg b/docs/public/qmk-logo-light.svg
new file mode 100644
index 0000000000..46b286c8b1
--- /dev/null
+++ b/docs/public/qmk-logo-light.svg
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+   width="512"
+   height="512"
+   viewBox="0 0 512 512"
+   version="1.1"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg">
+  <g>
+    <path
+       d="m 144.64051,512.00019 h -14.11395 c -3.89372,0 -7.05696,-3.16104 -7.05696,-7.05698 v -45.36247 h -9.97673 c -33.707631,0 -61.07342,-27.3658 -61.07342,-61.07345 v -9.97671 H 7.0569772 C 3.161054,388.53058 0,385.36734 0,381.4736 v -14.11395 c 0,-3.89371 3.161054,-7.05695 7.0569772,-7.05695 H 52.41945 V 329.32176 H 7.0569772 C 3.161054,329.32176 0,326.16071 0,322.26479 v -14.11395 c 0,-3.89373 3.161054,-7.05698 7.0569772,-7.05698 H 52.41945 V 270.11294 H 7.0569772 C 3.161054,270.11294 0,266.95189 0,263.05816 v -14.11394 c 0,-3.89592 3.161054,-7.05698 7.0569772,-7.05698 H 52.41945 V 210.90632 H 7.0569772 C 3.161054,210.90632 0,207.74308 0,203.84934 V 189.7354 c 0,-3.89373 3.161054,-7.05698 7.0569772,-7.05698 H 52.41945 V 151.6975 H 7.0569772 C 3.161054,151.6975 0,148.53646 0,144.64053 v -14.11395 c 0,-3.89372 3.161054,-7.05478 7.0569772,-7.05697 H 52.41945 v -9.97672 c 0,-33.707636 27.365789,-61.073424 61.07342,-61.073424 h 9.97673 V 7.0569776 C 123.4696,3.1610543 126.63284,0 130.52656,0 h 14.11395 c 3.89592,0 7.05698,3.1610543 7.05698,7.0569776 V 52.419466 h 30.98092 V 7.0569776 C 182.67841,3.1610543 185.83946,0 189.73539,0 h 14.11394 c 3.89373,0 7.05698,3.1610543 7.05698,7.0569776 V 52.419466 h 30.98092 V 7.0569776 C 241.88723,3.1610543 245.04828,0 248.9442,0 h 14.11175 c 3.89593,0 7.05698,3.1610543 7.05698,7.0569776 V 52.419466 h 30.98092 V 7.0569776 C 301.09385,3.1610543 304.25709,0 308.15083,0 h 14.11394 c 3.89592,0 7.05697,3.1610543 7.05697,7.0569776 V 52.419466 H 360.3026 V 7.0569776 C 360.3026,3.1610543 363.46362,0 367.35954,0 h 14.11387 c 3.89374,0 7.05698,3.1610543 7.05698,7.0569776 V 52.419466 h 9.97671 c 33.70765,0 61.07345,27.365788 61.07345,61.073424 v 9.97672 h 45.36247 c 3.89594,0.002 7.05699,3.16325 7.05699,7.05697 v 14.11395 c 0,3.89373 -3.16105,7.05697 -7.05699,7.05697 h -45.36247 v 30.98092 h 45.36247 c 3.89594,0.002 7.05699,3.16325 7.05699,7.05698 v 14.11394 c 0,3.89374 -3.16105,7.05479 -7.05699,7.05698 h -45.36247 v 30.98092 h 45.36247 c 3.89594,0 7.05699,3.16324 7.05699,7.05698 v 14.11394 c 0,3.89373 -3.16105,7.05478 -7.05699,7.05478 h -45.36247 v 30.98092 h 45.36247 c 3.89594,0.002 7.05699,3.16325 7.05699,7.05698 v 14.11395 c 0,3.89372 -3.16105,7.05697 -7.05699,7.05697 h -45.36247 v 30.98094 h 45.36247 c 3.89594,0.002 7.05699,3.16324 7.05699,7.05695 v 14.11395 c 0,3.89374 -3.16105,7.05479 -7.05699,7.05698 h -45.36247 v 9.97671 c 0,33.70765 -27.3658,61.07345 -61.07345,61.07345 h -9.97671 v 45.36247 c 0,3.89594 -3.16104,7.05698 -7.05698,7.05698 h -14.11387 c -3.89592,0 -7.05694,-3.16104 -7.05694,-7.05698 v -45.36247 h -30.98086 v 45.36247 c 0,3.89594 -3.16105,7.05698 -7.05697,7.05698 h -14.11394 c -3.89374,0 -7.05698,-3.16104 -7.05698,-7.05698 v -45.36247 h -30.98092 v 45.36247 c 0,3.89594 -3.16105,7.05698 -7.05698,7.05698 H 248.9442 c -3.89592,0 -7.05697,-3.16104 -7.05697,-7.05698 v -45.36247 h -30.98092 v 45.36247 c 0,3.89594 -3.16106,7.05698 -7.05698,7.05698 h -14.11394 c -3.89373,0 -7.05698,-3.16104 -7.05698,-7.05698 v -45.36247 h -30.98092 v 45.36247 c 0,3.89594 -3.16106,7.05698 -7.05698,7.05698 z m 227.56916,-279.1486 c 0,14.8598 -2.32965,28.17745 -6.99111,39.95297 -4.6593,11.77551 -11.30163,21.81804 -19.92924,30.12978 -8.62543,8.31174 -19.07817,14.73475 -31.35823,19.26903 -12.27786,4.53427 -26.16367,6.98896 -41.65303,7.36847 v 45.14753 c 0,1.00687 -0.25229,1.88871 -0.7568,2.64552 -0.50235,0.75464 -1.38419,1.35351 -2.64335,1.79443 -1.25915,0.44088 -2.92852,0.78531 -5.00591,1.03759 -2.07739,0.25247 -4.69222,0.37946 -7.84011,0.37946 -3.14789,0 -5.76052,-0.12737 -7.8401,-0.37946 -2.07739,-0.25209 -3.71385,-0.59671 -4.91159,-1.03759 -1.19553,-0.44092 -2.07738,-1.03979 -2.64334,-1.79443 -0.56818,-0.75678 -0.85114,-1.63865 -0.85114,-2.64552 v -45.14753 c -15.74164,-0.37948 -29.78319,-2.64554 -42.12467,-6.80251 -12.34367,-4.15478 -22.79641,-10.16757 -31.35823,-18.04058 -8.56401,-7.87082 -15.11425,-17.53604 -19.64633,-28.99568 -4.53428,-11.45963 -6.80251,-24.62153 -6.80251,-39.48131 v -96.53159 c 0,-0.88184 0.2852,-1.70008 0.85113,-2.4547 0.56594,-0.75679 1.44781,-1.38638 2.64554,-1.88873 1.19554,-0.5045 2.83201,-0.88184 4.91159,-1.13411 2.07738,-0.25228 4.69003,-0.37731 7.83791,-0.37731 3.15008,0 5.76272,0.12503 7.84011,0.37731 2.07738,0.25228 3.74675,0.62962 5.00591,1.13411 1.25916,0.50235 2.141,1.13193 2.64554,1.88873 0.50235,0.75465 0.75464,1.57286 0.75464,2.4547 v 93.69739 c 0,10.45274 1.38639,19.86789 4.15697,28.24106 2.77058,8.37535 6.92535,15.49155 12.46651,21.3464 5.54116,5.85706 12.56304,10.39132 21.06344,13.60283 8.50039,3.20932 18.41788,4.9423 29.75247,5.19457 V 139.72017 c 0,-0.88184 0.28298,-1.70008 0.85114,-2.4547 0.56595,-0.75679 1.51142,-1.38638 2.83201,-1.88873 1.32276,-0.5045 3.02284,-0.88184 5.10242,-1.13411 2.07739,-0.25228 4.56499,-0.37731 7.46061,-0.37731 3.14788,0 5.76272,0.12503 7.8401,0.37731 2.0774,0.25228 3.74676,0.62962 5.00591,1.13411 1.25916,0.50235 2.14101,1.13193 2.64335,1.88873 0.50451,0.75465 0.7568,1.57286 0.7568,2.4547 v 162.08225 c 11.3346,-0.12726 21.21918,-1.85802 29.65816,-5.19457 8.43678,-3.33874 15.45865,-7.93444 21.06343,-13.79148 5.60258,-5.85485 9.82316,-12.90743 12.65516,-21.15775 2.8342,-8.24814 4.2513,-17.41101 4.2513,-27.48425 v -94.4542 c 0,-0.88184 0.25228,-1.70008 0.75464,-2.4547 0.50451,-0.75679 1.38639,-1.38638 2.64555,-1.88873 1.25915,-0.5045 2.89781,-0.88184 4.91158,-1.13411 2.01594,-0.25228 4.65928,-0.37731 7.93438,-0.37731 3.02285,0 5.57186,0.12503 7.65143,0.37731 2.07736,0.25228 3.71381,0.62962 4.91154,1.13411 1.19554,0.50235 2.07736,1.13193 2.64335,1.88873 0.56595,0.75465 0.85111,1.57286 0.85111,2.4547 z"
+       style="fill:rgb(60,60,67);fill-rule:evenodd" />
+  </g>
+</svg>

From 8a394503c714aaf053e51bb3bbf2a4f8ea503c7b Mon Sep 17 00:00:00 2001
From: Joel Challis <git@zvecr.com>
Date: Thu, 30 May 2024 10:10:00 +0100
Subject: [PATCH 2/2] [docs] Update "Get Started" blocks (#23830)

Update "Get Started" blocks
---
 docs/index.md | 16 +++++++---------
 1 file changed, 7 insertions(+), 9 deletions(-)

diff --git a/docs/index.md b/docs/index.md
index 91f27a8a80..166bdc8ad9 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -6,19 +6,17 @@ QMK (*Quantum Mechanical Keyboard*) is an open source community centered around
 
 ## Get Started
 
-<div class="flex-container">
+::: tip Basic
+[QMK Configurator](newbs_building_firmware_configurator)
 
-::: tip
-**Basic** [QMK Configurator](newbs_building_firmware_configurator) <br>
-:::
 User friendly graphical interfaces, no programming knowledge required.
-
-::: tip
-**Advanced** [Use The Source](newbs) <br> 
 :::
-More powerful, but harder to use.
 
-</div>
+::: warning Advanced
+[Use The Source](newbs)
+
+More powerful, but harder to use.
+:::
 
 ## Make It Yours