You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
fix: correct Java version and builder-api port details in CONTRIBUTING.md
- devbox.json only provides JDK 21; library-api targets Java 17 via
Maven --release 17, not a separate JDK install
- Add builder-api (port 8081) to Service URLs table
- Clarify DIY setup requires JDK 21 only, not both 17 and 21
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+4-3Lines changed: 4 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -47,7 +47,7 @@ benefit-decision-toolkit/
47
47
└── process-compose.yml # Multi-service orchestration for local dev
48
48
```
49
49
50
-
**Important**: `library-api`uses**Java 17 + Quarkus 2.16.10** (required for Kogito), while `builder-api` uses **Java 21 + Quarkus 3.23.0**. Do not mix them up.
50
+
**Important**: `library-api`targets**Java 17 bytecode + Quarkus 2.16.10** (required for Kogito), while `builder-api` uses **Java 21 + Quarkus 3.23.0**. Devbox provides JDK 21 for both — Maven compiles `library-api` with `--release 17` automatically.
51
51
52
52
---
53
53
@@ -63,7 +63,7 @@ This is also a great way to test changes from a pull request — see the [Codesp
63
63
64
64
### Option 2: Devbox (Recommended for Local Development)
65
65
66
-
[Devbox](https://www.jetify.com/docs/devbox/) manages all project dependencies (Java 17, Java 21, Maven, Node.js 22, Firebase Tools, Bruno, etc.) using Nix, ensuring a consistent environment across machines.
66
+
[Devbox](https://www.jetify.com/docs/devbox/) manages all project dependencies (JDK 21, Maven, Node.js 22, Firebase Tools, Bruno, etc.) using Nix, ensuring a consistent environment across machines. A single JDK 21 covers both services — Maven handles the Java 17 target for `library-api` automatically via `--release 17`.
67
67
68
68
```bash
69
69
# Install Devbox + Nix and run one-time setup
@@ -81,7 +81,7 @@ Open the project in VS Code, install the `Dev Containers` extension, and run **"
81
81
82
82
### Option 4: DIY (Not Recommended)
83
83
84
-
Manually install the dependencies listed in `devbox.json` (JDK 17, JDK 21, Maven, Node.js 22, Firebase Tools 14.27.0, Bruno, process-compose), then run:
84
+
Manually install the dependencies listed in `devbox.json` (JDK 21, Maven, Node.js 22, Firebase Tools 14.27.0, Bruno, process-compose), then run:
85
85
86
86
```bash
87
87
bin/setup
@@ -131,6 +131,7 @@ cd builder-frontend && npm run dev
0 commit comments