Adding new content (#469)

* Adding new content

* Improving site support

* New improvements

* New progress

Author: jabrena

.gitignore

@@ -5,3 +5,4 @@ target/
 .classpath
 .claude
 dependency-reduced-pom.xml
+docs-local/

AGENTS.md

@@ -38,14 +38,15 @@ You are an expert Java developer and technical writer for this project.
 # Regenerate the website into docs/
 ./mvnw clean generate-resources -pl site-generator -P site-update
 
+# Serve the website locally (mirrors GitHub Pages path: http://localhost:8820/)
+./mvnw clean generate-resources jbake:inline -pl site-generator -P local-preview
+
 # Regenerate agent skills into skills/
 ./mvnw clean install -pl skills-generator
 
 # Validate agent skills
 npx skill-check skills
 
-# Serve the website locally
-jwebserver -p 8000 -d "$(pwd)/docs"
 ```
 
 ## Git workflow

DEVELOPER.md

@@ -37,7 +37,10 @@
 jwebserver -p 8005 -d "$(pwd)/target/site/"
 
 # Run blog in local
-jwebserver -p 8005 -d "$(pwd)/docs/"
+./mvnw clean generate-resources jbake:inline -pl site-generator -P local-preview
+
+# Promote blog changes to Prod
+./mvnw clean generate-resources -pl site-generator -P site-update
 ```
 
 ## Plugin Goals Reference
@@ -46,104 +49,132 @@ The following sections list useful goals for each plugin configured in this proj
 
 ### maven-enforcer-plugin
 
-| Goal | Description |
-|------|-------------|
-| `./mvnw enforcer:enforce` | Execute enforcer rules |
+
+| Goal                           | Description                          |
+| ------------------------------ | ------------------------------------ |
+| `./mvnw enforcer:enforce`      | Execute enforcer rules               |
 | `./mvnw enforcer:display-info` | Display current platform information |
 
+
 ### spotless-maven-plugin
 
-| Goal | Description |
-|------|-------------|
-| `./mvnw spotless:apply` | Apply formatting fixes |
+
+| Goal                    | Description                             |
+| ----------------------- | --------------------------------------- |
+| `./mvnw spotless:apply` | Apply formatting fixes                  |
 | `./mvnw spotless:check` | Check formatting and fail on violations |
 
+
 ### versions-maven-plugin
 
-| Goal | Description |
-|------|-------------|
-| `./mvnw versions:display-dependency-updates` | Show available dependency updates |
-| `./mvnw versions:display-plugin-updates` | Show available plugin updates |
-| `./mvnw versions:display-property-updates` | Show available property updates |
-| `./mvnw versions:use-latest-releases` | Update dependencies to latest releases |
-| `./mvnw versions:set -DnewVersion=X.Y.Z` | Set the project version |
+
+| Goal                                         | Description                            |
+| -------------------------------------------- | -------------------------------------- |
+| `./mvnw versions:display-dependency-updates` | Show available dependency updates      |
+| `./mvnw versions:display-plugin-updates`     | Show available plugin updates          |
+| `./mvnw versions:display-property-updates`   | Show available property updates        |
+| `./mvnw versions:use-latest-releases`        | Update dependencies to latest releases |
+| `./mvnw versions:set -DnewVersion=X.Y.Z`     | Set the project version                |
+
 
 ### spotbugs-maven-plugin
 
-| Goal | Description |
-|------|-------------|
-| `./mvnw spotbugs:check` | Run SpotBugs analysis and fail on bugs |
-| `./mvnw spotbugs:spotbugs` | Generate a SpotBugs report |
-| `./mvnw spotbugs:gui` | Launch the SpotBugs GUI |
+
+| Goal                       | Description                            |
+| -------------------------- | -------------------------------------- |
+| `./mvnw spotbugs:check`    | Run SpotBugs analysis and fail on bugs |
+| `./mvnw spotbugs:spotbugs` | Generate a SpotBugs report             |
+| `./mvnw spotbugs:gui`      | Launch the SpotBugs GUI                |
+
 
 ### maven-pmd-plugin
 
-| Goal | Description |
-|------|-------------|
-| `./mvnw pmd:check` | Run PMD analysis and fail on violations |
-| `./mvnw pmd:pmd` | Generate a PMD report |
+
+| Goal                   | Description                                     |
+| ---------------------- | ----------------------------------------------- |
+| `./mvnw pmd:check`     | Run PMD analysis and fail on violations         |
+| `./mvnw pmd:pmd`       | Generate a PMD report                           |
 | `./mvnw pmd:cpd-check` | Run copy-paste detection and fail on duplicates |
 
+
 ### dependency-check-maven
 
-| Goal | Description |
-|------|-------------|
-| `./mvnw dependency-check:check` | Run OWASP dependency check and fail on CVSS threshold |
-| `./mvnw dependency-check:aggregate` | Aggregate vulnerability report for multi-module projects |
-| `./mvnw dependency-check:update-only` | Update the local NVD database only |
-| `./mvnw dependency-check:purge` | Delete the local NVD database cache |
+
+| Goal                                  | Description                                              |
+| ------------------------------------- | -------------------------------------------------------- |
+| `./mvnw dependency-check:check`       | Run OWASP dependency check and fail on CVSS threshold    |
+| `./mvnw dependency-check:aggregate`   | Aggregate vulnerability report for multi-module projects |
+| `./mvnw dependency-check:update-only` | Update the local NVD database only                       |
+| `./mvnw dependency-check:purge`       | Delete the local NVD database cache                      |
+
 
 ### maven-compiler-plugin
 
-| Goal | Description |
-|------|-------------|
-| `./mvnw compiler:compile` | Compile main source files |
+
+| Goal                          | Description               |
+| ----------------------------- | ------------------------- |
+| `./mvnw compiler:compile`     | Compile main source files |
 | `./mvnw compiler:testCompile` | Compile test source files |
 
+
 ### maven-surefire-plugin
 
-| Goal | Description |
-|------|-------------|
-| `./mvnw surefire:test` | Run unit tests |
+
+| Goal                   | Description              |
+| ---------------------- | ------------------------ |
+| `./mvnw surefire:test` | Run unit tests           |
 | `./mvnw surefire:help` | Display help information |
 
+
 ### maven-resources-plugin
 
-| Goal | Description |
-|------|-------------|
-| `./mvnw resources:resources` | Copy main resources to output directory |
+
+| Goal                             | Description                             |
+| -------------------------------- | --------------------------------------- |
+| `./mvnw resources:resources`     | Copy main resources to output directory |
 | `./mvnw resources:testResources` | Copy test resources to output directory |
 
+
 ### maven-clean-plugin
 
-| Goal | Description |
-|------|-------------|
+
+| Goal                 | Description                       |
+| -------------------- | --------------------------------- |
 | `./mvnw clean:clean` | Delete the build output directory |
 
+
 ### jbake-maven-plugin
 
-| Goal | Description |
-|------|-------------|
-| `./mvnw jbake:generate` | Generate the static site with JBake |
-| `./mvnw jbake:inline` | Generate and serve the site with a built-in server |
-| `./mvnw jbake:watch` | Watch for source changes and regenerate automatically |
+
+| Goal                    | Description                                           |
+| ----------------------- | ----------------------------------------------------- |
+| `./mvnw jbake:generate` | Generate the static site with JBake                   |
+| `./mvnw jbake:inline`   | Generate and serve the site with a built-in server    |
+| `./mvnw jbake:watch`    | Watch for source changes and regenerate automatically |
+
 
 ## Maven Profiles
 
 The following profiles are declared in this project. Activate them with `-P <profileId>`.
 
-| Profile ID | Command | Activation | Description |
-|------------|---------|------------|-------------|
-| `security` | `./mvnw clean verify -P security` | manual | Runs OWASP Dependency-Check against all scopes and fails the build on any vulnerability with a CVSS score ≥ 7. |
-| `find-bugs` | `./mvnw clean verify -P find-bugs` | manual | Runs SpotBugs (Max effort, Low threshold) and PMD static analysis, failing the build on any detected issue. |
-| `site-update` | `./mvnw clean generate-resources -pl site-generator -P site-update` | manual | Cleans the `docs/` folder, generates the GitHub Pages static site with JBake, and copies conference assets into `docs/`. |
+
+| Profile ID      | Command                                                                 | Activation | Description                                                                                                              |
+| ---------------- | ----------------------------------------------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------ |
+| `security`       | `./mvnw clean verify -P security`                                       | manual     | Runs OWASP Dependency-Check against all scopes and fails the build on any vulnerability with a CVSS score ≥ 7.           |
+| `find-bugs`   | `./mvnw clean verify -P find-bugs`                                  | manual     | Runs SpotBugs (Max effort, Low threshold) and PMD static analysis, failing the build on any detected issue.              |
+| `site-update` | `./mvnw clean generate-resources -pl site-generator -P site-update` | manual     | Cleans the `docs/` folder, generates the GitHub Pages static site with JBake, and copies conference assets into `docs/`. |
+| `local-preview`  | `./mvnw clean generate-resources jbake:inline -pl site-generator -P local-preview` | manual     | Generates the site to `target/docs-local`, copies images, and serves at http://localhost:8820/ for local preview.       |
+
 
 ## Submodules
 
 This is a multi-module project. The following modules are declared in the root `pom.xml`.
 
-| Module | Artifact ID | Commands | Description |
-|--------|-------------|----------|-------------|
-| `system-prompts-generator` | `cursor-rules-java-generator` | `./mvnw clean verify -pl system-prompts-generator`<br>`./mvnw clean install -pl system-prompts-generator` | Transforms XML rule sources via XInclude and XSLT into Markdown cursor rules, then deploys them to `.cursor/rules/`. |
-| `skills-generator` | `cursor-rules-java-skills-generator` | `./mvnw clean verify -pl skills-generator`<br>`./mvnw clean install -pl skills-generator` | Generates agent skills from the cursor rules and deploys them to `skills/`. |
-| `site-generator` | `cursor-rules-java-site` | `./mvnw clean verify -pl site-generator`<br>`./mvnw clean generate-resources -pl site-generator -P site-update` | Generates the project's GitHub Pages static website using JBake and publishes output to `docs/`. |
+
+| Module                     | Artifact ID                          | Commands                                                                                                     | Description                                                                                                          |
+| -------------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------- |
+| `system-prompts-generator` | `cursor-rules-java-generator`        | `./mvnw clean verify -pl system-prompts-generator` `./mvnw clean install -pl system-prompts-generator`       | Transforms XML rule sources via XInclude and XSLT into Markdown cursor rules, then deploys them to `.cursor/rules/`. |
+| `skills-generator`         | `cursor-rules-java-skills-generator` | `./mvnw clean verify -pl skills-generator` `./mvnw clean install -pl skills-generator`                       | Generates agent skills from the cursor rules and deploys them to `skills/`.                                          |
+| `site-generator`           | `cursor-rules-java-site`             | `./mvnw clean verify -pl site-generator`                                                                       | Generates the project's GitHub Pages static website using JBake. Use the `site-update` profile to publish to `docs/`. |
+
+

README.md

@@ -22,7 +22,7 @@
 
 ## Goal
 
-The project provides a collection of `System prompts` & `Skills` for Java Enterprise development that help software engineers and pipelines in their daily programming work.
+The project provides a curated collection of `System prompts` & `Skills` for Java Enterprise development that help software engineers and pipelines in their daily programming work.
 The project covers aspects like `Build system based on Maven`, `Design`, `Coding`, `Testing`, `Refactoring & JMH Benchmarking`, `Performance testing with JMeter`, `Profiling with Async profiler/OpenJDK tools`, `Documentation`, `ADRs`, `Diagrams` & `AGENTS.md`.
 
 ## Deliverables
@@ -134,13 +134,15 @@ Java uses JEPs as the vehicle to describe new features to be added to the langua
 - https://agentskills.io/home
 - https://github.com/anthropics/skills
 - https://skills.sh/
+- https://github.com/vercel-labs/skills/issues
 - https://skillsmp.com/
 - https://cursor.com/docs/cli/github-actions
 - https://code.claude.com/docs/en/github-actions
 - [https://www.anthropic.com/claude-code](https://www.anthropic.com/claude-code)
 - [https://github.com/features/copilot](https://github.com/features/copilot)
 - [https://www.jetbrains.com/junie/](https://www.jetbrains.com/junie/)
 - [https://openjdk.org/jeps/0](https://openjdk.org/jeps/0)
+- https://jbake.org/docs/latest/
 
 ## Cursor rules ecosystem
 

docs/2/index.html

@@ -78,7 +78,7 @@
 <div class="page-heading">
 <h1>Cursor rules and Skills for Java</h1>
   <hr class="small">
-  <span class="page-subheading">A collection of System prompts and Skills for Java Enterprise development that help software engineers in their daily programming work & pipelines.</span>
+  <span class="page-subheading">A curated collection of System prompts and Skills for Java Enterprise development that help software engineers in their daily programming work & pipelines.</span>
 </div>
 </div>
 </div>
@@ -93,7 +93,7 @@ <h1>Cursor rules and Skills for Java</h1>
 <div class="page-heading">
 <h1>Cursor rules and Skills for Java</h1>
   <hr class="small">
-  <span class="page-subheading">A collection of System prompts and Skills for Java Enterprise development that help software engineers in their daily programming work & pipelines.</span>
+  <span class="page-subheading">A curated collection of System prompts and Skills for Java Enterprise development that help software engineers in their daily programming work & pipelines.</span>
 </div>
 </div>
 </div>