Merge branch '4.0.x' into patch-32

Author: fdevans

.circleci/config.yml

@@ -6,7 +6,7 @@ jobs:
   build:
     docker:
       # specify the version you desire here
-      - image: cimg/node:18.19.0
+      - image: cimg/node:22.12.0
         environment:
           NODE_OPTIONS="--max-old-space-size=6144"
     resource_class: medium+

.docsearch/config.json

@@ -8,7 +8,7 @@
         "version": [
           "docs",
           "4.0.x",
-          "5.13.0"
+          "5.14.0"
         ]
       }
     }

.github/copilot-instructions.md

@@ -0,0 +1,41 @@
+# GitHub Copilot Instructions for Rundeck Documentation
+
+You are an AI assistant helping maintain the Rundeck documentation site.
+
+## Project Context
+- This repository contains documentation for Rundeck, an open-source job scheduler and runbook automation tool
+- Documentation is primarily written in Markdown and organized by product versions
+- Documentation follows a specific structure with product versions, features, and administration guides
+- Documentation is built using VuePress 2 and the Hope Theme.
+
+## Key Documentation Guidelines
+- Use clear, concise language
+- Follow technical writing best practices
+- Include practical examples where appropriate
+- Ensure all code examples are properly formatted and functional
+- Maintain consistent terminology throughout the documentation
+- Use proper heading hierarchy (H1 > H2 > H3)
+- Include descriptive alt text for images
+
+## Common Tasks
+- Creating new documentation pages
+- Updating existing documentation for new releases
+- Fixing formatting issues in Markdown files
+- Improving code examples
+- Enhancing clarity of technical explanations
+- Cross-referencing related documentation
+
+## Directory Structure
+- `/docs/` - Main documentation content
+- `/docs/manual/` - Core product documentation
+- `/docs/administration/` - Administration guides
+- `/docs/api/` - API documentation
+- `/docs/developer/` - Developer documentation
+- `/docs/learning/` - Tutorials and learning resources
+
+## Markdown Guidelines
+- Use ATX-style headers (`#` for H1, `##` for H2)
+- Code blocks should specify language for proper syntax highlighting
+- Use numbered lists for sequential steps
+- Use bullet points for non-sequential items
+- Tables should have headers and consistent column formatting

.nvmrc

@@ -1 +1 @@
-18.19.0
+22.12.0

README.md

@@ -1,10 +1,10 @@
 # Rundeck Documentation
 Rundeck Documentation project.
 
-## Getting starting
+## Getting Started
 
 ### Dependencies
-* NodeJS `lts/hydrogen` or version `18.19.0` is the currently supported and only version that should be used.
+* NodeJS version `22.12.0` is the currently supported and only version that should be used.
 * NVM is helpful in making sure your machine is using the currently supported versions as we upgrade in the future.
 
 ### Recommended setup steps
@@ -18,10 +18,7 @@ After setting the proper Node version, run this `npm` command before the first y
 npm install
 ```
 
-## API Documentation Guidelines
-
-Our API Documentation is now handled by OpenAPI spec and presented using Swagger UI.
-
+>Note: It may be helpful to delete any existing `node_modules` folder and the `package-lock.json` file before running npm install.
 
 # How To 
 
@@ -78,6 +75,13 @@ git checkout -b 3.2.8
 git push origin
 ```
 
+## Documentation Structure
+
+The documentation is organized as follows:
+- `/docs/` - Main documentation content
+- `/docs/.vuepress/` - VuePress configuration
+- `/docs/.vuepress/public/assets/img/` - Images Folder
+
 # How to Create Release Notes
 
 Rundeck Core PRs are included by default.

docs/.vuepress/client.ts

@@ -1,5 +1,7 @@
 import { defineClientConfig } from '@vuepress/client'
 import '@docsearch/css'
+import Layout from "./layouts/Layout.vue";
+import NotFound from "./layouts/NotFound.vue";
 
 declare const VERSION: string;
 declare const VERSION_FULL: string;
@@ -11,6 +13,10 @@ declare const CLI_VERSION: string;
 
 
 export default defineClientConfig({
+  layouts: {
+    Layout,
+    NotFound,
+  },
   enhance({ app, router, siteData }) {
     Object.defineProperties(app.config.globalProperties, {
       $rundeckVersion: { get: () => VERSION },