jenkinsci
diff --git a/‎.gitignore‎
Lines changed: 1 addition & 0 deletions b/‎.gitignore‎
Lines changed: 1 addition & 0 deletions
diff --git a/‎README.md‎
Lines changed: 32 additions & 7 deletions b/‎README.md‎
Lines changed: 32 additions & 7 deletions
diff --git a/‎pom.xml‎
Lines changed: 0 additions & 4 deletions b/‎pom.xml‎
Lines changed: 0 additions & 4 deletions
diff --git a/‎src/main/java/org/jenkins/plugins/lockableresources/actions/LockableResourcesManagementLink.java‎
Lines changed: 65 additions & 0 deletions b/‎src/main/java/org/jenkins/plugins/lockableresources/actions/LockableResourcesManagementLink.java‎
Lines changed: 65 additions & 0 deletions
@@ -3,3 +3,4 @@
 /.idea/
 /target/
 /work/
+/jsbundles/
@@ -32,9 +32,8 @@ Thx very much for supporting us.
 
 ### Adding lockable resources
 
-1. In *Manage Jenkins* > *Configure System* go to **Lockable Resources
-   Manager**
-2. Select *Add Lockable Resource*
+1. In *Manage Jenkins* > *Lockable Resources* (under the Configuration category)
+2. Click *Add Resource* in the top bar
 
 Each lockable resource has the following properties:
 
@@ -47,7 +46,7 @@ Each lockable resource has the following properties:
   `DK_Printer_Production`, `DK_Printer_Engineering`
 - **Reserved by** - Optional reserved / locked cause. If non-empty,
   the resource will be unavailable for jobs. i.e. `All printers are currently not available due to maintenance.`
-  This option is still possible, but we recommend to use the page `<jenkinsRootUrl>/lockable-resources/`
+  This option is still possible, but we recommend to use the *Manage Jenkins* > *Lockable Resources* page
 
 A resource is always the one thing that is locked (or free or reserved).
 It exists once and has an unique name (if we take the hardware example, this may be `office_printer_14`).
@@ -397,14 +396,25 @@ Fields like *reservedBy*, *reservedTimestamp* or *note* are not supported, they
 
 ## lockable-resources overview
 
-The page `<jenkinsRootUrl>/lockable-resources/` provides an overview over all lockable-resources.
+The page *Manage Jenkins* > *Lockable Resources* (also accessible at `<jenkinsRootUrl>/lockable-resources/`) provides a management dashboard for all lockable resources. When accessed from Manage Jenkins, it renders with the sidebar layout; when accessed directly via the URL, it renders as a standalone page.
+
+The page has four tabs: **Overview**, **Resources**, **Labels**, and **Queue**.
+
+### Overview
+
+Provides at-a-glance stats including a resource donut chart (locked/reserved/free), utilization percentages, top labels, and queue metrics (longest wait, most contended resource). Cards are clickable to jump to the relevant tab.
 
 ### Resources
 
-Provides an status overview over all resources and actions to change resource status.
+Provides a status overview of all resources and actions to change resource status.
+
+Resources can be created, edited, and deleted directly from this tab using the **Add Resource** button and per-row edit/delete actions (requires CONFIGURE permission). Bulk actions (reserve, unreserve, unlock, steal) are available via multi-select checkboxes.
 
 Name | Permission | Description
 -----|------------|------------
+Add Resource | CONFIGURE | Creates a new lockable resource.
+Edit (Gear Icon) | CONFIGURE | Edits an existing resource (name, description, labels, properties).
+Delete | CONFIGURE | Deletes a resource (only if not locked, reserved, or queued).
 Reserve | RESERVE | Reserves an available resource for currently logged user indefinitely (until that person, or some explicit scripted action, decides to release the resource).
 Unreserve | RESERVE | Un-reserves a resource that may be reserved by some person already. The user can unreserve only own resource. Administrator can unreserve any resource.
 Unlock | UNLOCK | Unlocks a resource that may be or not be locked by some job (or reserved by some user) already.
@@ -421,7 +431,7 @@ Provides an overview over all lockable-resources labels.
 
 ### Queue
 
-Provides an overview over currently queued requests.
+Provides an overview of currently queued requests with server-side pagination for performance with large queues.
 A request is queued by the pipeline step `lock()`. When the requested resource(s) is currently in use (not free), then any new request for this resource will be added into the queue.
 
 A resource may be requested by:
@@ -433,6 +443,21 @@ A resource may be requested by:
 
 > *Note:* An empty value in the column 'Requested at' means that this build has been started in an older plugin version - [1117.v157231b_03882](https://github.com/jenkinsci/lockable-resources-plugin/releases/tag/1117.v157231b_03882) and early. In this case we cannot recognize the timestamp.
 
+### Permissions
+
+The plugin defines its own permission group under *Manage Jenkins* > *Security* > *Authorization*:
+
+Permission | Implied by | Description
+-----------|------------|------------
+View | Jenkins.READ | See the lockable resources page and resource status.
+Configure | Jenkins.ADMINISTER | Create, edit, and delete resources.
+Unlock | Jenkins.ADMINISTER | Manually unlock a resource.
+Reserve | Jenkins.ADMINISTER | Reserve or unreserve a resource.
+Steal | Jenkins.ADMINISTER | Steal a lock from another build.
+Queue | Jenkins.ADMINISTER | Reorder the lock wait queue.
+
+All mutating permissions default to `ADMINISTER`, preserving existing behavior. Admins can delegate individual permissions to specific roles without granting full admin access.
+
 ----
 
 ## Upgrading from 1102.vde5663d777cf
 
@@ -83,10 +83,6 @@
       <groupId>io.jenkins.plugins</groupId>
       <artifactId>caffeine-api</artifactId>
     </dependency>
-    <dependency>
-      <groupId>io.jenkins.plugins</groupId>
-      <artifactId>data-tables-api</artifactId>
-    </dependency>
     <dependency>
       <groupId>org.jenkins-ci.plugins</groupId>
       <artifactId>mailer</artifactId>
 
@@ -0,0 +1,65 @@
+package org.jenkins.plugins.lockableresources.actions;
+
+import edu.umd.cs.findbugs.annotations.NonNull;
+import hudson.Extension;
+import hudson.model.ManagementLink;
+import hudson.model.RootAction;
+import hudson.security.Permission;
+import jenkins.model.Jenkins;
+import org.jenkins.plugins.lockableresources.Messages;
+import org.kohsuke.accmod.Restricted;
+import org.kohsuke.accmod.restrictions.NoExternalUse;
+
+/**
+ * ManagementLink that renders the Lockable Resources page inside the Manage Jenkins
+ * settings-subpage layout (with the Manage Jenkins sidebar). This keeps the plugin
+ * discoverable and integrated within the management UI for admins.
+ *
+ * <p>Non-admin users with only the VIEW permission access the page via the
+ * {@link LockableResourcesRootAction} at {@code /lockable-resources/} instead.
+ */
+@Extension
+@Restricted(NoExternalUse.class)
+public class LockableResourcesManagementLink extends ManagementLink {
+
+    @Override
+    public String getIconFileName() {
+        return Jenkins.get().hasPermission(LockableResourcesRootAction.VIEW) ? LockableResourcesRootAction.ICON : null;
+    }
+
+    @Override
+    public String getDisplayName() {
+        return Messages.LockableResourcesRootAction_PermissionGroup();
+    }
+
+    @Override
+    public String getUrlName() {
+        return "lockable-resources";
+    }
+
+    @Override
+    public String getDescription() {
+        return Messages.LockableResourcesRootAction_ManagementLink_Description();
+    }
+
+    @NonNull
+    @Override
+    public Category getCategory() {
+        return Category.CONFIGURATION;
+    }
+
+    @NonNull
+    @Override
+    public Permission getRequiredPermission() {
+        return LockableResourcesRootAction.VIEW;
+    }
+
+    /**
+     * Returns the RootAction instance so the Jelly view can delegate content rendering.
+     * Used by {@code index.jelly}.
+     */
+    @Restricted(NoExternalUse.class)
+    public LockableResourcesRootAction getAction() {
+        return Jenkins.get().getExtensionList(RootAction.class).get(LockableResourcesRootAction.class);
+    }
+}