Add warning to User Guide re: default test instance lifecycle

Issue: junit-team#905
Andrei94 · Jun 23, 2018 · e16cc3a · e16cc3a
1 parent 7b35bba
commit e16cc3a
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/documentation/src/docs/asciidoc/writing-tests.adoc b/documentation/src/docs/asciidoc/writing-tests.adoc
@@ -214,6 +214,12 @@ you can start your JVM with the following system property.
 
 `-Djunit.jupiter.testinstance.lifecycle.default=per_class`
 
+WARNING: Changing the _default_ test instance lifecycle mode can lead to unpredictable
+results and fragile builds if not applied consistently. For example, if the build
+configures "per-class" semantics as the default but tests in the IDE are executed using
+"per-method" semantics, that can make it difficult to debug errors that occur on the
+build server.
+
 [[writing-tests-nested]]
 === Nested Tests