From c12d62df4c98cf1d197d39ee6de03d534980401b Mon Sep 17 00:00:00 2001
From: Jan <janf@kainos.com>
Date: Mon, 23 Jun 2025 13:54:39 +0100
Subject: [PATCH 1/3] Add integration page (WIP)

---
 .../plugins/designlibrary/Integration.java    | 25 ++++++++++++++++
 .../designlibrary/Integration/index.jelly     | 30 +++++++++++++++++++
 2 files changed, 55 insertions(+)
 create mode 100644 src/main/java/io/jenkins/plugins/designlibrary/Integration.java
 create mode 100644 src/main/resources/io/jenkins/plugins/designlibrary/Integration/index.jelly

diff --git a/src/main/java/io/jenkins/plugins/designlibrary/Integration.java b/src/main/java/io/jenkins/plugins/designlibrary/Integration.java
new file mode 100644
index 00000000..b72684f8
--- /dev/null
+++ b/src/main/java/io/jenkins/plugins/designlibrary/Integration.java
@@ -0,0 +1,25 @@
+package io.jenkins.plugins.designlibrary;
+
+import hudson.Extension;
+
+@Extension
+public class Integration extends UISample {
+
+    @Override
+    public String getIconFileName() {
+        return "symbol-extension-puzzle-outline plugin-ionicons-api";
+    }
+
+    @Override
+    public String getDescription() {
+        return "Defines the palette for consistent use of color.";
+    }
+
+    @Override
+    public Category getCategory() {
+        return Category.PATTERN;
+    }
+
+    @Extension
+    public static final class DescriptorImpl extends UISampleDescriptor {}
+}
diff --git a/src/main/resources/io/jenkins/plugins/designlibrary/Integration/index.jelly b/src/main/resources/io/jenkins/plugins/designlibrary/Integration/index.jelly
new file mode 100644
index 00000000..1d48f44c
--- /dev/null
+++ b/src/main/resources/io/jenkins/plugins/designlibrary/Integration/index.jelly
@@ -0,0 +1,30 @@
+<?jelly escape-by-default='true'?>
+<j:jelly xmlns:j="jelly:core" xmlns:s="/lib/samples" xmlns:l="/lib/layout" xmlns:t="/lib/hudson" xmlns:f="/lib/form">
+  <s:layout>
+    <s:section title="${%topAppBar}" description="${%topAppBar.description}">
+      <s:group>
+        <s:preview fullWidth="true">
+          <div class="jdl-app-bars-page__example jdl-app-bars-page__example--top">
+            <l:pageHeader title="${null}"
+                          logoAlt="${null}"
+                          searchPlaceholder="${null}"
+                          searchHelpUrl="$null}"
+                          logout="${null}"/>
+          </div>
+        </s:preview>
+        <s:code file="topAppBar.jelly" />
+      </s:group>
+
+      <s:dos-donts>
+        <tr>
+          <td>${%topAppBar.do.1}</td>
+          <td>${%topAppBar.dont.1}</td>
+        </tr>
+        <tr>
+          <td>${%topAppBar.do.2}</td>
+          <td>${%topAppBar.dont.2}</td>
+        </tr>
+      </s:dos-donts>
+    </s:section>
+  </s:layout>
+</j:jelly>

From 2c5cffcd4325bedc482f5aeec8ac3632aaeaa655 Mon Sep 17 00:00:00 2001
From: Jan <janf@kainos.com>
Date: Mon, 23 Jun 2025 13:58:47 +0100
Subject: [PATCH 2/3] Add more guidance

---
 .../io/jenkins/plugins/designlibrary/Integration.java     | 2 +-
 .../jenkins/plugins/designlibrary/Integration/index.jelly | 8 ++++++++
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/src/main/java/io/jenkins/plugins/designlibrary/Integration.java b/src/main/java/io/jenkins/plugins/designlibrary/Integration.java
index b72684f8..22a3d559 100644
--- a/src/main/java/io/jenkins/plugins/designlibrary/Integration.java
+++ b/src/main/java/io/jenkins/plugins/designlibrary/Integration.java
@@ -12,7 +12,7 @@ public String getIconFileName() {
 
     @Override
     public String getDescription() {
-        return "Defines the palette for consistent use of color.";
+        return "Guidance for integrating your plugin further into Jenkins.";
     }
 
     @Override
diff --git a/src/main/resources/io/jenkins/plugins/designlibrary/Integration/index.jelly b/src/main/resources/io/jenkins/plugins/designlibrary/Integration/index.jelly
index 1d48f44c..fd7e8e4d 100644
--- a/src/main/resources/io/jenkins/plugins/designlibrary/Integration/index.jelly
+++ b/src/main/resources/io/jenkins/plugins/designlibrary/Integration/index.jelly
@@ -15,6 +15,14 @@
         <s:code file="topAppBar.jelly" />
       </s:group>
 
+      <div>
+        is your plugin tied to a single page/context? if so it should live on that page inside of the app bar.
+      </div>
+
+      <div>
+        is your plugin a management item? it should live in manage jenkins then
+      </div>
+
       <s:dos-donts>
         <tr>
           <td>${%topAppBar.do.1}</td>

From 7547516b8085c9fc47163f889af941caba290180 Mon Sep 17 00:00:00 2001
From: Jan <janf@kainos.com>
Date: Mon, 23 Jun 2025 14:19:50 +0100
Subject: [PATCH 3/3] Update Integration.java

---
 .../java/io/jenkins/plugins/designlibrary/Integration.java   | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/main/java/io/jenkins/plugins/designlibrary/Integration.java b/src/main/java/io/jenkins/plugins/designlibrary/Integration.java
index 22a3d559..8315bee5 100644
--- a/src/main/java/io/jenkins/plugins/designlibrary/Integration.java
+++ b/src/main/java/io/jenkins/plugins/designlibrary/Integration.java
@@ -20,6 +20,11 @@ public Category getCategory() {
         return Category.PATTERN;
     }
 
+    @Override
+    public String getSince() {
+        return "2.515";
+    }
+
     @Extension
     public static final class DescriptorImpl extends UISampleDescriptor {}
 }