Update documentation

Author: ipavlic

README.md

@@ -5,6 +5,17 @@
 
 Apex FP provides functional constructs for `SObject` collections!
 
+## Read the documentation
+
+<a href="https://www.apexfp.org">Apex FP documentation</a>
+
+## Deploy to Salesforce
+
+<a href="https://githubsfdeploy.herokuapp.com?owner=ipavlic&repo=apex-fp&ref=main">
+  <img alt="Deploy to Salesforce"
+       src="https://raw.githubusercontent.com/afawcett/githubsfdeploy/master/deploy.png">
+</a>
+
 ## Examples
 
 ### Filter
@@ -92,17 +103,4 @@ OptionalDecimal min = SObjectCollection.of(opportunities).mapToDecimal(Opportuni
 
 ```apex
 OptionalDecimal max = SObjectCollection.of(opportunities).mapToDecimal(Opportunity.Amount).max();
-```
-
-Find more examples <a href="https://apexfp.org/examples">in the documentation</a>.
-
-## Deploy to Salesforce
-
-<a href="https://githubsfdeploy.herokuapp.com?owner=ipavlic&repo=apex-fp&ref=main">
-  <img alt="Deploy to Salesforce"
-       src="https://raw.githubusercontent.com/afawcett/githubsfdeploy/master/deploy.png">
-</a>
-
-## Read the documentation
-
-<a href="https://www.apexfp.org">Apex FP documentation</a>
+```

force-app/main/default/classes/function/MatchFieldCondition.cls

@@ -13,6 +13,8 @@ public class MatchFieldCondition {
 		this.value = value;
 	}
 
+	private class SetComparison()
+
 	public Boolean isSatisfied(SObject record) {
 		Object fieldValue = fieldReader.read(record, fieldPath);
 		switch on relation {

website/docs/api/function/AssignToSObject.md

@@ -1,27 +1,27 @@
-# IncompleteFieldsMatch
+# IncompleteMatchFields
 
-`IncompleteFieldsMatch` starts the fluent interface for building a [`FieldsMatch`](FieldsMatch). Adding a condition through methods on the `IncompleteFieldsMatch` yields a `FieldsMatch`, which is an [`SObjectPredicate`](SObjectPredicate). The process can be continued to add more field conditions.
+`IncompleteMatchFields` starts the fluent interface for building a [`MatchFields`](MatchFields). Adding a condition through methods on the `IncompleteMatchFields` yields a `MatchFields`, which is an [`SObjectPredicate`](SObjectPredicate). The process can be continued to add more field conditions.
 
 ## equals (alias eq)
 
 Defines an equality comparison condition for the current field.
 
 **Signature**
 ```
-FieldsMatch equals(Object value)
+MatchFields equals(Object value)
 ```
 
 **Signature**
 ```
-FieldsMatch eq(Object value)
+MatchFields eq(Object value)
 ```
 ## notEquals (alias neq)
 
 Defines an inequality comparison condition for the current field.
 
 **Signature**
 ```
-FieldsMatch notEquals(Object value)
+MatchFields notEquals(Object value)
 ```
 
 ## lessThan (alias lt)
@@ -30,7 +30,7 @@ Defines a less than comparison condition for the current field.
 
 **Signature**
 ```
-FieldsMatch lessThan(Object value)
+MatchFields lessThan(Object value)
 ```
 
 ## lessThanOrEquals (alias leq)
@@ -39,7 +39,7 @@ Defines a less than or equals condition for the current field.
 
 **Signature**
 ```
-FieldsMatch lessThanOrEquals(Object value)
+MatchFields lessThanOrEquals(Object value)
 ```
 
 ## greaterThan (alias gt)
@@ -48,7 +48,7 @@ Defines a greater than condition for the current field.
 
 **Signature**
 ```
-FieldsMatch greaterThan(Object value)
+MatchFields greaterThan(Object value)
 ```
 
 ## greaterThanOrEquals (alias geq)
@@ -57,7 +57,7 @@ Defines a greater than or equals condition for the current field.
 
 **Signature**
 ```
-FieldsMatch greaterThanOrEquals(Object value)
+MatchFields greaterThanOrEquals(Object value)
 ```
 
 ## hasValue
@@ -66,7 +66,7 @@ Defines a non-null condition for the current field.
 
 **Signature**
 ```
-FieldsMatch hasValue()
+MatchFields hasValue()
 ```
 
 ## isIn
@@ -75,12 +75,12 @@ Defines a set membership condition for the current field. `value` has to be a `S
 
 **Signature**
 ```
-FieldsMatch isIn(Object value)
+MatchFields isIn(Object value)
 ```
 
 ## isNotIn (alias `ntIn)
 
 **Signature**
 ```
-FieldsMatch isNotIn(Object value)
+MatchFields isNotIn(Object value)
 ```

website/docs/api/function/FieldsMatch.md

@@ -0,0 +1,22 @@
+# MatchFields
+
+`MatchFields` implements [`SObjectPredicate`](SObjectPredicate) and returns `true` if a record satisfies all field matching conditions currently defined. `MatchFields` is constructed from an [`IncompleteMatchFields`](IncompleteMatchFields) with a fluent interface.
+
+Additional conditions can be defined with `also`, or its alias `field`, to create complex matching functions.
+
+## also (alias field)
+
+Adds another field condition to the chain.
+
+**Signature**
+
+```
+IncompleteMatchFields also(Schema.SObjectField field)
+IncompleteMatchFields also(String fieldPath)
+```
+
+**Example**
+
+```
+MatchFields m = Match.field(Account.Name).equals('Foo').also(Account.AnnualRevenue).greaterThan(100000);
+```

website/docs/api/function/IncompleteFieldsMatch.md

@@ -1,14 +1,14 @@
-# RecordFieldsMatch
+# MatchRecordFields
 
 Implements [`SObjectPredicate`](SObjectPredicate).
 
-## RecordFieldsMatch
+## MatchRecordFields
 
-Constructs a `RecordFieldsMatch` for a given `prototype`.
+Constructs a `MatchRecordFields` for a given `prototype`.
 
 **Signature**
 ```
-public RecordFieldsMatch(sObject prototype)
+public MatchRecordFields(sObject prototype)
 ```
 
 ## call

website/docs/api/function/MatchFields.md

@@ -0,0 +1,32 @@
+# ModifySObject
+
+Implements [`SObjectFunction`](SObjectFunction), and modifies the record it is applied to. Field values can be defined through a fluent interface. It is meant to be used in `forEach` of [`SObjectCollection`](../collection/SObjectCollection) and [`SObjectStream`](../stream/SObjectStream).
+
+## setField
+
+Defines the value of a field. 
+
+**Signature**
+```
+ModifySObject setField(String targetFieldName, Object value)
+ModifySObject setField(Schema.SObjectField field, Object value)
+```
+
+## setFields
+
+Defines the value of multiple fields.
+
+**Signature**
+```
+ModifySObject setFields(Map<Schema.SObjectField, Object> fieldValues)
+ModifySObject setFields(SObject prototype)
+```
+
+## call
+
+Assigns the defined values to `record`.
+
+**Signature**
+```
+void call(SObject record)
+```