ClickHouse / ClickHouse/clickhouse-java

Inconsistency between documentation and ChangeLogs regarding minimum JDK runtime requirements

Open
#2,126 2 comments 1 reaction 0 assignees View on GitHub
area:docs v2-feedback
Dominant language
Java
Stars
1.6k
Forks
636
Avg merge
2d 23h
Merged PRs (30d)
29

Description

### Describe your feedback

- Inconsistency between documentation and ChangeLogs regarding minimum JDK runtime requirements.
- For https://github.com/ClickHouse/clickhouse-java/releases/tag/v0.6.4 , it is mentioned that,

```
Lowest supported Java version will be 11.
Java 11 support will be ended before the end of 2023.
It is recommended to use Java 21.
```

- ![Image](https://github.com/user-attachments/assets/cf0eb009-80e9-41bd-bc0e-7c0409eb9ae8)

- But https://clickhouse.com/docs/en/integrations/java/jdbc-v2#environment-requirements mentions,
```
Environment requirements
[OpenJDK](https://openjdk.java.net/) version >= 8
```
- ![Image](https://github.com/user-attachments/assets/a57ae968-f37c-4e45-bb05-b38ba0aad5e3)

- This is a bit of a conflict from my perspective. Is the minimum JDK runtime requirement now JDK8, or JDK11?

### Code example

- Probably not.

Contributor guide

Open the contributing guide

Research direction

Compare the v0.6.4 release notes with the JDBC v2 Environment requirements page linked in the issue, and confirm the current minimum supported JDK. Update the conflicting documentation references so they state the same requirement, then verify both pages and any related release documentation use consistent wording.

Written by the indexing model from the issue text.

Assessment

Tech stack
java
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
58/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.