review

Author: triceo

README.adoc

@@ -68,7 +68,7 @@ There are three editions of Timefold Solver:
 
 - _Timefold Solver Community Edition_,
 - _Timefold Solver Plus_
-- and _Timefold Solver Enterprise.
+- and _Timefold Solver Enterprise_.
 
 The Community Edition (this repo) is open-source and licensed under the Apache-2.0 license.
 The latter two are non-open-source commercial offerings and require a Timefold license to run.

core/src/main/java/ai/timefold/solver/core/api/score/calculator/AnalyzableIncrementalScoreCalculator.java

@@ -11,8 +11,8 @@
  * Any implementation is naturally stateful.
  * <p>
  * Note: Explainability features are exclusive to Timefold Solver Enterprise Edition.
- * They are not available in the open-source version of Timefold Solver,
- * and using this interface will have no effect there.
+ * Implementing this interface in Community Edition may still bring benefits
+ * in terms of score corruption analysis.
  *
  * @param <Solution_> the solution type, the class with the {@link PlanningSolution} annotation
  * @param <Score_> the score type to go with the solution

core/src/main/java/ai/timefold/solver/core/api/score/calculator/ConstraintMatchRegistry.java

@@ -10,11 +10,6 @@
 import org.jspecify.annotations.NullMarked;
 
 /**
- * <p>
- * Note: Explainability features are exclusive to Timefold Solver Enterprise Edition.
- * They are not available in the open-source version of Timefold Solver,
- * and using this class will have no effect there.
- *
  * @param <Score_>
  * @see AnalyzableIncrementalScoreCalculator Adding explainability to incremental score calculator.
  */

docs/src/modules/ROOT/pages/upgrading-timefold-solver/upgrade-from-v1.adoc

@@ -321,13 +321,14 @@ The following `ScoreExplanation` methods have no direct replacement and must be
 
 `IncrementalScoreCalculator` has also seen changes in this area.
 `ConstraintMatchAwareIncrementalScoreCalculator` was removed.
-The replacement `AnalyzableIncrementalScoreCalculator` is provided by the Enterprise Edition.
+The replacement `AnalyzableIncrementalScoreCalculator` is provided by the Plus and Enterprise editions.
 
 Instead of overriding methods to return constraint matches, implement the `enableConstraintMatch(ConstraintMatchRegistry<Score_>)` method.
 Use `ConstraintMatchRegistry.registerConstraintMatch(ConstraintRef, score, justification)` to register each match;
 it returns a `ConstraintMatchRegistration` whose `cancel()` method removes the match when the assignment changes.
 
-Add the Timefold Solver Enterprise dependency to your project to use `ScoreAnalysis` or `AnalyzableIncrementalScoreCalculator`.
+To use `ScoreAnalysis` or `AnalyzableIncrementalScoreCalculator`,
+xref:commercial-editions/installation.adoc[install either of the commercial editions].
 There is no automated migration recipe for these changes; all changes must be made manually.
 ====