Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Nov 18, 2025

Description

Standardizes Java 25 as the minimum required version across all contributor-facing documentation and workspace tooling. The project already uses Java 25 in pom.xml and CI workflows, but developer documentation still referenced Java 17.

Resolves #378

Changes

  • Documentation updates: Updated copilot-instructions.md and README.md to specify Java 25 as minimum version
  • SDKMAN setup instructions: Added installation examples using sdk install java 25.0.1-tem with guidance to run sdk list java for platform-specific identifiers
  • Devcontainer configuration: Created .devcontainer/devcontainer.json with:
    • Microsoft Java 25 devcontainer image with Temurin distribution
    • VS Code Java extensions pre-configured
    • Java feature configured for version 25 with Temurin distribution

Setup Example

Contributors can now install Java 25 via SDKMAN:

curl -s "https://get.sdkman.io" | bash
sdk install java 25.0.1-tem
java -version

Or simply open the repository in a devcontainer/Codespace for automatic setup.

Checklist:

  • Public methods are documented
  • Public methods are tested
  • New and existing tests pass when run locally
  • There are no new warnings or errors
Original prompt

This section details on the original issue you should resolve

<issue_title>[Chore]: Standardize Java 25 setup and documentation</issue_title>
<issue_description>### What

Update project documentation and workspace tooling to standardize on Java 25 for all contributors. This includes: updating copilot-instructions.md and README.md to specify Java 25; providing instructions and examples for pinning a JVM identifier with SDKMAN; and adding a devcontainer.json that installs Java 25 automatically with a fallback SDKMAN install.

Why

Ensures consistent environment setup, reduces onboarding friction, improves reproducibility, and makes workspace setup easier for Codespaces, devcontainers, and local development.

Notes

Use SDKMAN to pin JVM installs (e.g. sdk install java 25.0.1-tem) and advise contributors to run sdk list java for platform-specific IDs. The devcontainer.json should include both the official Java feature and SDKMAN, with a postCreateCommand fallback. Update documentation to reflect Java 25 as the minimum required version.</issue_description>

Comments on the Issue (you are @copilot in this section)


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Co-authored-by: thomasturrell <1552612+thomasturrell@users.noreply.github.com>
Copilot AI changed the title [WIP] Update project documentation for Java 25 standardization Standardize Java 25 setup and documentation Nov 18, 2025
Co-authored-by: thomasturrell <1552612+thomasturrell@users.noreply.github.com>
@thomasturrell thomasturrell marked this pull request as ready for review November 18, 2025 11:37
Copilot AI review requested due to automatic review settings November 18, 2025 11:37
Copilot AI requested a review from thomasturrell November 18, 2025 11:37
@sonarqubecloud
Copy link

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR standardizes Java 25 as the minimum required version across all contributor-facing documentation and development environments. The project already uses Java 25 in pom.xml and CI workflows, but developer documentation previously referenced Java 17.

Key Changes:

  • Updated minimum Java version from 17 to 25 in README.md and copilot-instructions.md
  • Added SDKMAN installation instructions with Java 25 (Temurin) examples
  • Created devcontainer configuration for automatic Java 25 setup in Codespaces/devcontainers

Reviewed Changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File Description
README.md Updated minimum Java version requirement to 25 and added SDKMAN installation instructions
.github/copilot-instructions.md Updated Technology Stack to require Java 25 and added Environment Setup section with SDKMAN instructions
.devcontainer/devcontainer.json Created new devcontainer configuration with Java 25, Maven, and VS Code Java extensions

@thomasturrell thomasturrell merged commit 281af38 into main Nov 18, 2025
12 checks passed
@thomasturrell thomasturrell deleted the copilot/standardize-java-25-setup branch November 18, 2025 11:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Chore]: Standardize Java 25 setup and documentation

2 participants