first commit

Library/PackageCache/com.unity.test-framework@1.1.33/Documentation~/reference-comparer-equals.md

@@ -0,0 +1,27 @@
+# Custom equality comparers with equals operator
+
+If you need to compare Vectors using the overloaded operator == (see [Vector2.operator ==](https://docs.unity3d.com/ScriptReference/Vector2-operator_eq.html),  [Vector3.operator ==](https://docs.unity3d.com/ScriptReference/Vector3-operator_eq.html), and [Vector4.operator ==](https://docs.unity3d.com/ScriptReference/Vector4-operator_eq.html))  you should use the respective comparer implementations:
+
+- Vector2ComparerWithEqualsOperator
+- Vector3ComparerWithEqualsOperator
+- Vector4ComparerWithEqualsOperator
+
+The interface is the same as for other [equality comparers](./reference-custom-equality-comparers.md) except the public [constructor](./reference-custom-equality-comparers.md#constructors) `error` parameter is inapplicable in this case. 
+
+## Example
+
+```c#
+[TestFixture]
+public class Vector3Test
+{
+    [Test]
+    public void VerifyThat_TwoVector3ObjectsAreEqual()
+    {
+        var actual = new Vector3(10e-7f, 10e-7f, 10e-7f);
+        var expected = new Vector3(0f, 0f, 0f);
+
+        Assert.That(actual, Is.EqualTo(expected).Using(Vector3ComparerWithEqualsOperator.Instance));
+    }
+}
+```
+