This is an automated email from the ASF dual-hosted git repository. rombert pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/sling-whiteboard.git
commit 30e7fcaf12a325e5b16d86debf48cd2ad34939af Author: Robert Munteanu <[email protected]> AuthorDate: Fri Apr 17 18:24:54 2026 +0200 skills: update README --- skills/README.md | 34 ++++++++++++++++++++++++++++++++-- 1 file changed, 32 insertions(+), 2 deletions(-) diff --git a/skills/README.md b/skills/README.md index 1e7fdd09..3d8ca162 100644 --- a/skills/README.md +++ b/skills/README.md @@ -4,7 +4,37 @@ A set of [Agent Skills](https://agentskills.io/) for Apache Sling developers and Current skills: -- update-sling-parent-pom: Updates the parent POM of a Sling project to the next version. +- `update-sling-parent-pom`: Updates the parent POM of a Sling project to the next version. + +## Prerequisites + +First of all, install and configure a coding assistant that supports Agent Skills. + +### Invoking Apache Maven with different Java versions + +The `update-sling-parent-pom` skill requires running Apache Maven with older JVM versions. Therefore it expects the following commands to exist: + +- `mvn8`: Apache Maven running with Java 8 +- `mvn11`: Apache Maven running with Java 11 +- `mvn17`: Apache Maven running with Java 17 +- `mvn21`: Apache Maven running with Java 21 + +There is no generic solution for creating these scripts. One approach is to create small wrapper scripts and add them to PATH. For example, `mvn11` would be: + +```bash +#!/bin/sh -e + +JAVA_HOME=/usr/lib64/jvm/java-11 +export JAVA_HOME + +mvn "$@" +``` + +### Generating diffs for for OSGi components + +Some parent pom updates require changes to the OSGi components descriptors. These can be validated using the [osgi-ds-metatype-diff](https://github.com/jsedding/osgi-ds-metatype-diff) tool. Since there is no release of this tool yet you will need to build it and install it to your local Maven repository. Building using `-DskipTests -DskipITs` is required for recent Java versions. + +This dependency is optional but recommended. ## Installation @@ -14,4 +44,4 @@ Using [npx skills](https://github.com/vercel-labs/skills): npx skills add apache/sling-whiteboard ``` -Alternatively, clone the repository and copy the skill to a locations supported by your coding assitant. +Alternatively, clone the repository and copy the skill to a locations supported by your coding assistant.
