From 9310e90b352d664db76ae976fcac2cdb4f72e7fb Mon Sep 17 00:00:00 2001
From: Alexander Schwartz <aschwart@redhat.com>
Date: Fri, 24 Jan 2025 10:44:00 +0100
Subject: [PATCH] Adding a 404 page with the option to create a broken link
 issue

Signed-off-by: Alexander Schwartz <aschwart@redhat.com>
---
 .github/ISSUE_TEMPLATE/bug.yml | 32 ++++++++++++++++++++++++++++++++
 pages/404.ftl                  | 30 ++++++++++++++++++++++++++++++
 2 files changed, 62 insertions(+)
 create mode 100644 .github/ISSUE_TEMPLATE/bug.yml
 create mode 100644 pages/404.ftl

diff --git a/.github/ISSUE_TEMPLATE/bug.yml b/.github/ISSUE_TEMPLATE/bug.yml
new file mode 100644
index 00000000..0248b3ad
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug.yml
@@ -0,0 +1,32 @@
+name: Website Problem Report
+description: Report a problem on Keycloak's website
+labels: ["kind/bug", "status/triage", "area/docs"]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Describe the problem
+      description: Provide a clear and concise description of what the problem is.
+    validations:
+      required: true
+  - type: textarea
+    id: behaviorExpected
+    attributes:
+      label: Expected behavior
+      description: Describe what content you were expecting.
+    validations:
+      required: true
+  - type: textarea
+    id: reproducer
+    attributes:
+      label: How to Reproduce?
+      description: Describe how you reached this site, for example by adding a link where this page was referenced.
+    validations:
+      required: false
+  - type: textarea
+    id: other
+    attributes:
+      label: Anything else?
+      description: Links? References? Anything that will give us more context about the issue you are encountering!
+    validations:
+      required: false
diff --git a/pages/404.ftl b/pages/404.ftl
new file mode 100644
index 00000000..d2f84bd2
--- /dev/null
+++ b/pages/404.ftl
@@ -0,0 +1,30 @@
+<#import "/templates/template.ftl" as tmpl>
+
+<@tmpl.page current="keys" title="Page not found" noindex=true>
+
+<div class="container mt-5">
+    <h1>Page not found</h1>
+
+    <p>
+        The page you’re looking for does not exist. It may have been moved. You can return to <a href="${links.home}">the start page</a>, or follow one of the links in the navigation on the top.
+    </p>
+    <p>
+        If you arrived at this page by clicking on a link, please notify the owner of the site that the link is broken. If you typed the URL of this page manually, please double-check that you entered the address correctly.
+    </p>
+
+    <p>
+        If you think this is a bug that the Keycloak team should fix, create <a id="buglink" href="https://github.com/keycloak/keycloak-web/issues/new?template=bug.yml&title=Broken%20link%20on%20the%20website%20{url}&description=%0A%0AURL:%20{url}">a bug issue on the GitHub issue tracker</a>.
+    </p>
+
+    <script>
+        document.addEventListener("DOMContentLoaded", function() {
+            var buglink = document.getElementById("buglink")
+            var href = buglink.getAttribute("href")
+            href = href.replaceAll("\{url\}", encodeURIComponent(window.location))
+            buglink.setAttribute("href", href)
+        });
+    </script>
+
+</div>
+
+</@tmpl.page>