Merge pull request #114 from fingerprintjs/doc-factory-reset-smart-si…

…gnal

Attempt to clarify documentation for Factory Reset Smart Signal.

schemas/fingerprint-server-api.yaml

@@ -1752,15 +1752,17 @@ components:
       additionalProperties: false
       properties:
         time:
-          title: Time
-          description: >
-            Time in UTC when the most recent factory reset of the Android or iOS device was done. 
-            If there is no sign of factory reset or the client is not a mobile device, the field will contain the epoch time (1 January 1970) in UTC.
+          description: |
+            Indicates the time (in UTC) of the most recent factory reset that happened on the **mobile device**. 
+            When a factory reset cannot be detected on the mobile device or when the request is initiated from a browser, this field will correspond to the *epoch* time (i.e 1 Jan 1970 UTC).
+            See [Factory Reset Detection](https://dev.fingerprint.com/docs/smart-signals-overview#factory-reset-detection) to learn more about this Smart Signal.
           type: string
           format: date-time
           example: '2022-06-09T22:58:36Z'
         timestamp:
-          description: Same value as it's in the `time` field but represented in timestamp format.
+          description: |
+            This field is just another representation of the value in the `time` field.
+            The time of the most recent factory reset that happened on the **mobile device** is expressed as Unix epoch time.       
           type: integer
           format: int64
           example: 1654815517198