Add documentation for the factory methods to Condition and Facet classes (#602)

If people don't read the documentation they are may not aware of the
`Condition::` or `Facet::` methods. So it should be documented also in
the code via PHPDocs.

Author: alexander-schranz

packages/seal/src/Search/Condition/AndCondition.php

@@ -13,6 +13,9 @@
 
 namespace CmsIg\Seal\Search\Condition;
 
+/**
+ * Recommended way to create a new instance is use the {@see Condition::and} factory method.
+ */
 class AndCondition extends AbstractGroupCondition
 {
 }

packages/seal/src/Search/Condition/EqualCondition.php

@@ -13,6 +13,9 @@
 
 namespace CmsIg\Seal\Search\Condition;
 
+/**
+ * Recommended way to create a new instance is use the {@see Condition::equal} factory method.
+ */
 class EqualCondition
 {
     public function __construct(

packages/seal/src/Search/Condition/GeoBoundingBoxCondition.php

@@ -13,6 +13,9 @@
 
 namespace CmsIg\Seal\Search\Condition;
 
+/**
+ * Recommended way to create a new instance is use the {@see Condition::geoBoundingBox} factory method.
+ */
 class GeoBoundingBoxCondition
 {
     /**

packages/seal/src/Search/Condition/GeoDistanceCondition.php

@@ -13,6 +13,9 @@
 
 namespace CmsIg\Seal\Search\Condition;
 
+/**
+ * Recommended way to create a new instance is use the {@see Condition::geoDistance} factory method.
+ */
 class GeoDistanceCondition
 {
     /**

packages/seal/src/Search/Condition/GreaterThanCondition.php

@@ -13,6 +13,9 @@
 
 namespace CmsIg\Seal\Search\Condition;
 
+/**
+ * Recommended way to create a new instance is use the {@see Condition::greaterThan} factory method.
+ */
 class GreaterThanCondition
 {
     public function __construct(

packages/seal/src/Search/Condition/GreaterThanEqualCondition.php

@@ -13,6 +13,9 @@
 
 namespace CmsIg\Seal\Search\Condition;
 
+/**
+ * Recommended way to create a new instance is use the {@see Condition::greaterThanEqual} factory method.
+ */
 class GreaterThanEqualCondition
 {
     public function __construct(

packages/seal/src/Search/Condition/IdentifierCondition.php

@@ -13,6 +13,9 @@
 
 namespace CmsIg\Seal\Search\Condition;
 
+/**
+ * Recommended way to create a new instance is use the {@see Condition::identifier} factory method.
+ */
 class IdentifierCondition
 {
     public function __construct(

packages/seal/src/Search/Condition/InCondition.php

@@ -13,6 +13,9 @@
 
 namespace CmsIg\Seal\Search\Condition;
 
+/**
+ * Recommended way to create a new instance is use the {@see Condition::in} factory method.
+ */
 class InCondition
 {
     /**

packages/seal/src/Search/Condition/LessThanCondition.php

@@ -13,6 +13,9 @@
 
 namespace CmsIg\Seal\Search\Condition;
 
+/**
+ * Recommended way to create a new instance is use the {@see Condition::lessThan} factory method.
+ */
 class LessThanCondition
 {
     public function __construct(

packages/seal/src/Search/Condition/LessThanEqualCondition.php

@@ -13,6 +13,9 @@
 
 namespace CmsIg\Seal\Search\Condition;
 
+/**
+ * Recommended way to create a new instance is use the {@see Condition::lessThanEqual} factory method.
+ */
 class LessThanEqualCondition
 {
     public function __construct(