Hello, 

Following section 18.4.1.2 of the 8.14.0.FINAL documentation (https://docs.optaplanner.org/8.14.0.Final/optaplanner-docs/html_single/#configureAPinningFilter ) The description is in contradiction with the source code's java doc of the PinningFilter Interface :

From doc:
add a PinningFilter that returns true if an entity is movable, and false if it is pinned. This is more flexible and more verbose than the @PlanningPin approach.

In code: 

public interface PinningFilter<Solution_, Entity_> {

    /**
     * @param solution working solution to which the entity belongs
     * @param entity never null, a {@link PlanningEntity}
     * @return true if the entity it is pinned, false if the entity is movable.
     */
    boolean accept(Solution_ solution, Entity_ entity);

} 

Nothing major, but worth noting.