anchor.diff:  [[examplesOverview]]
   == Examples Overview
   
  -Planner has several examples.
  -In this manual we explain mainly using the n queens example and cloud balancing example.
  -So it's advisable to read at least those sections.
  +Planner has several examples. In this manual we explain mainly using the _n_ queens example and cloud balancing example. So it is advisable to read at least those sections.
  +
  +The `Competition?` column in the following table identifies an example as being either realistic or unrealistic. A _realistic competition_ is _an official, independent competition_:
  +
  +* that clearly defines a real-word use case.
  +* with real-world constraints.
  +* with multiple, real-world datasets.
  +* that expects reproducible results within a specific time limit on specific hardware.
  +* that has had serious participation from the academic and/or enterprise Operations Research community.
  +
  +These realistic competitions provide an objective comparison of Planner with competitive software and academic research.
   
   The source code of all these examples is available in the distribution zip under [path]_examples/sources_
   and also in git under [path]_optaplanner/optaplanner-examples_.
  
positive.code: [[employeeRosteringProblemSize]]
  ==== Problem Size
  
  There are 3 dataset types:
  
  * sprint: must be solved in seconds.
  * medium: must be solved in minutes.
  
negative.code: 256queens has 256 queens with a search space of 10^616.
  ----
  
  The implementation of the _n_ queens example has not been optimized because it functions as a beginner example. Nevertheless, it can easily handle 64 queens.
  With a few changes it has been shown to easily handle 5000 queens and more.
  
  
  [[nQueensDomainModel]]
  ==== Domain Model
  
  This example uses the domain model to solve the four queens problem.
  
  . *Creating a Domain Model* 
  A good domain model will make it easier to understand and solve your planning problem.
  +
  This is the domain model for the _n_ queens example:
  +
  [source,java,options="nowrap"]
  ----
  public class Column {
  