anchor.diff:      }
   ----
   
  -However, that scales poorly because it doesn't do an <<incrementalScoreCalculation,incremental calculation>>:
  -When the planning variable of a single `Talk` changes, to recalculate the score,
  -the normal Streams API has to execute the entire stream from scratch.
  -
  -On the other hand, the ConstraintStreams API uses <<incrementalScoreCalculation,deltas>>:
  +However, this approach scales poorly because it does not perform an <<incrementalScoreCalculation,incremental calculation>>.
  +In the previous example,when the planning variable of a single `Talk` intety changes, to recalculate the score the Java streams package must execute the entire stream from scratch.
  +
  +//COMMENT: Lukas I have made the Java streams API lowercase and not code - it looks like it's a general term that includes specific packages, for exmpl java.util.stream. Let me know if I'm mistaken. Also, if I'm using 'package' incorrectly.
  +
  +On the other hand, the `ConstraintStreams` API uses <<incrementalScoreCalculation,deltas>>:
   
   ////
   TODO Replace the previous sentence when PLANNER-1709 is fixed.
  
positive.code: 
  
  [[constraintStreamsIntroduction]]
  == Introduction
  
  Using Java 8's Streams API, we could implement an <<easyJavaScoreCalculation,easy score calculator>>
  that uses a functional approach:
  
  [source,java,options="nowrap"]
  ----
  
negative.code: So it doesn't do <<incrementalScoreCalculation,deltas>>.
  Nor does it support <<explainingTheScore,justifications>>.
  
  On the other hand, the `ConstraintStreams` API uses <<incrementalScoreCalculation,deltas>>
  and supports <<explainingTheScore,justifications>>:
  ////
  
  