Skip to content

Improve instructions in CONTRIBUTING.md#2871

Open
dplyukhin wants to merge 6 commits into
masterfrom
dplyukhin/improve-contributing-guide
Open

Improve instructions in CONTRIBUTING.md#2871
dplyukhin wants to merge 6 commits into
masterfrom
dplyukhin/improve-contributing-guide

Conversation

@dplyukhin
Copy link
Copy Markdown

What was changed

Updated CONTRIBUTING.md and mise.toml, adding missing gradle toolchain dependencies.

Also fixed test instructions in CONTRIBUTING.md, which incorrectly state that a temporal server needs to be running during tests. Explained how to run the tests that do require a temporal server.

Why?

The project wouldn't build when following the old instructions. The instructions were also omitting some tests that require a temporal server to be running.

Add missing gradle toolchain dependencies to the list of Java version
requirements, both in CONTRIBUTING.md and mise.toml.

Fix test instructions in CONTRIBUTING.md, which incorrectly state that a
temporal server needs to be running during tests. Explain how to run the
tests that *do* require a temporal server.
@dplyukhin dplyukhin requested a review from a team as a code owner May 5, 2026 21:59
@CLAassistant
Copy link
Copy Markdown

CLAassistant commented May 5, 2026

CLA assistant check
All committers have signed the CLA.

@dplyukhin dplyukhin added the documentation Improvements or additions to documentation label May 5, 2026
Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md
@dplyukhin dplyukhin enabled auto-merge (squash) May 11, 2026 15:39
Comment thread temporal-sdk/src/test/java/io/temporal/activity/ActivityPauseTest.java Outdated
Comment thread temporal-sdk/src/test/java/io/temporal/worker/StickyWorkerTest.java
Comment thread CONTRIBUTING.md Outdated
- Java 23+
- Docker to run Temporal Server
- **Java 23+** is required to run Gradle and to compile the project.
- Some tests assume you also have **Java 17 and 21** installed.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I don't think this is correct? Some tests require a minimum of 17 or 21, but all of them will run fine on 23 and later too. Is there any test that doesn't?

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

These lines cause the build to fail unless JDK 17 and 21 toolchains are installed. It looks like we really just wanted at least 17 and 21, so I've updated those lines in the latest commit.

Comment thread mise.toml Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants