From c3b1678d3befd165c2f9553cda2e947141fd4078 Mon Sep 17 00:00:00 2001
From: Tiara Lena Hock <hock@b1-systems.de>
Date: Tue, 21 Apr 2026 12:34:38 +0200
Subject: [PATCH] Docs: Improve Landing Page

* Remove Reference Section from Quicklinks
* Add quicklink to error reporting guide
* Create custom social link to gardenlinux repo issue selector

Signed-off-by: Tiara Lena Hock <hock@b1-systems.de>
---
 docs/.vitepress/config.mts      | 18 ++++++++++++++----
 docs/how-to/reporting-issues.md |  2 +-
 docs/index.md                   |  9 ++++++---
 3 files changed, 21 insertions(+), 8 deletions(-)

diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts
index 091c72d..0bd186c 100644
--- a/docs/.vitepress/config.mts
+++ b/docs/.vitepress/config.mts
@@ -1,8 +1,8 @@
-import { defineConfig } from "vitepress";
-import { generateDocumentationSidebar } from "./sidebar.js";
 import { readdir, readFile } from "fs/promises";
-import { join } from "path";
 import matter from "gray-matter";
+import { join } from "path";
+import { defineConfig } from "vitepress";
+import { generateDocumentationSidebar } from "./sidebar.js";
 
 // Get base URL from environment variable (for GitHub Pages deployment)
 const base = process.env.BASE_URL || "/";
@@ -189,7 +189,17 @@ export default defineConfig({
 
     sidebar: documentationSidebar,
 
-    socialLinks: [{ icon: "github", link: "https://github.com/gardenlinux" }],
+    socialLinks: [
+      { icon: "github", link: "https://github.com/gardenlinux", ariaLabel: "Source Code" },
+      { icon: {
+        svg:
+            `
+            <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="bi bi-bug" viewBox="0 0 16 16">
+                <path d="M4.355.522a.5.5 0 0 1 .623.333l.291.956A5 5 0 0 1 8 1c1.007 0 1.946.298 2.731.811l.29-.956a.5.5 0 1 1 .957.29l-.41 1.352A5 5 0 0 1 13 6h.5a.5.5 0 0 0 .5-.5V5a.5.5 0 0 1 1 0v.5A1.5 1.5 0 0 1 13.5 7H13v1h1.5a.5.5 0 0 1 0 1H13v1h.5a1.5 1.5 0 0 1 1.5 1.5v.5a.5.5 0 1 1-1 0v-.5a.5.5 0 0 0-.5-.5H13a5 5 0 0 1-10 0h-.5a.5.5 0 0 0-.5.5v.5a.5.5 0 1 1-1 0v-.5A1.5 1.5 0 0 1 2.5 10H3V9H1.5a.5.5 0 0 1 0-1H3V7h-.5A1.5 1.5 0 0 1 1 5.5V5a.5.5 0 0 1 1 0v.5a.5.5 0 0 0 .5.5H3c0-1.364.547-2.601 1.432-3.503l-.41-1.352a.5.5 0 0 1 .333-.623M4 7v4a4 4 0 0 0 3.5 3.97V7zm4.5 0v7.97A4 4 0 0 0 12 11V7zM12 6a4 4 0 0 0-1.334-2.982A3.98 3.98 0 0 0 8 2a3.98 3.98 0 0 0-2.667 1.018A4 4 0 0 0 4 6z"/>
+            </svg>
+            `
+      }, link: "https://github.com/gardenlinux/gardenlinux/issues/new/choose", ariaLabel: "Report a Bug" }
+    ],
 
     editLink: {
       pattern: ({ filePath, frontmatter }) => {
diff --git a/docs/how-to/reporting-issues.md b/docs/how-to/reporting-issues.md
index 8a31c65..f71ca46 100644
--- a/docs/how-to/reporting-issues.md
+++ b/docs/how-to/reporting-issues.md
@@ -14,7 +14,7 @@ To do so, first identify which component of the project gives you troubles and
 open a new bug in the appropriate repository:
 
 - [Gardenlinux - The Main Repo](https://github.com/gardenlinux/gardenlinux/issues/new/choose)
-- [Builder](https://github.com/gardenlinux/builder/issues/new/choose)
+- [Builder - The Image Building Utility](https://github.com/gardenlinux/builder/issues/new/choose)
 - [GLRD - The Garden Linux Release Database](https://github.com/gardenlinux/glrd/issues/new/choose)
 - [Python Library - python-gardenlinux-lib](https://github.com/gardenlinux/python-gardenlinux-lib/issues/new/choose)
 
diff --git a/docs/index.md b/docs/index.md
index 2606868..864f953 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -41,15 +41,18 @@ features:
   - title: Explanation
     details: Understanding-oriented content that provides context and background
     link: /explanation/
-  - title: Reference
-    details: Information-oriented technical specifications and lookup tables
-    link: /reference/
+  # - title: Reference
+  #   details: Information-oriented technical specifications and lookup tables
+  #   link: /reference/
   - title: Contributing
     details: Guides for contributing to Garden Linux documentation and development
     link: /contributing/
   - title: Releases
     details: Overview which Garden Linux Releases are available
     link: /reference/releases/
+  - title: Report an Issue
+    details: Learn how to report any issue you face with Garden Linux
+    link: /how-to/reporting-issues
 
 migration_status: "adapt"
 migration_issue: https://github.com/gardenlinux/gardenlinux/issues/4622