Improve documentation on Parallel Test Execution in JUnit Vintage engine

[YongGoose]

The current JUnit user guide provides an explanation of test configuration for parallel execution in the JUnit Vintage engine.
However, I believe it should be clearer and more detailed.

In JUnit Vintage, users can configure parallel execution at both the class and method levels independently.
This can lead to various execution scenarios, and it is important to clearly inform users about these possibilities.

Since I implemented this myself, feel free to reach out to me if you have any questions while working on this issue.

Deliverables

• Add table of relevant configuration parameters (This PR should be helpful)
• Provide clear examples of parallel execution scenarios for both class and method levels

Related Documents

• Improve documentation on Parallel Test Execution #2669 (comment)
• Support parallelization in junit-vintage-engine #4135
• Implement Parallel Method Execution in JUnit-Vintage engine #4242
• https://junit.org/junit5/docs/snapshot/user-guide/index.html#migrating-from-junit4-parallel-execution

[etrandafir93]

hello @marcphilipp - can i work on this issue?

[marcphilipp]

@etrandafir93 Sure! Before you start, let's clarify a few things, though.

Add table of relevant configuration parameters (This PR should be helpful)

I think the current description list is more readable, especially on small screens, than the table we have for Jupiter's parallel configuration.

@YongGoose Do you think anything is missing from it or what did you have in mind?

[YongGoose]

I think the current description list is more readable, especially on small screens, than the table we have for Jupiter's parallel configuration.

I didn’t consider small screens.
After checking on my phone, I agree that Vintage’s parallel configuration has better readability than Jupiter’s parallel configuration.

Add table of relevant configuration parameters (This #2946 should be helpful)

Now, I don’t think this task is necessary.

[marcphilipp]

@etrandafir93 If you're still interested, feel free to go ahead and start working on the remaining "deliverable" in the issue description. 🙂

[etrandafir93]

@marcphilipp - sounds good, I'll start looking into it and keep you posted 👍

[etrandafir93]

hello @marcphilipp, @YongGoose - I have added some simple examples with the possible config combinations.
Let me know what you think