@picked/client 0.0.1-dev.1787543060859 → 0.0.1-dev.1787788898336

package/dist/docs/reference/sdk/fields.md

@@ -124,36 +124,50 @@ const conditionalField = createField({
 
 ## Field policies
 
-Use a privacy policy to control how Picked tracks and stores the data of a field:
+A field captures nothing until you permit it. Use a privacy policy to let Picked track
+or store the data of a field:
 
 ```ts
-const sensitiveField = createField({
-  id: 'ssn',
-  name: 'ssn',
+const colourField = createField({
+  id: 'favourite-colour',
+  name: 'favourite-colour',
   type: 'text',
-  label: 'Social Security Number',
+  label: 'Favourite colour',
   multiple: false,
   required: true,
   policies: {
-    doNotTrackValue: true, // Do not send the value to analytics.
-    doNotStoreValue: true, // Do not keep the value in browser storage.
+    doNotTrackValue: false, // Send the value to analytics.
+    doNotStoreValue: false, // Keep the value in browser storage.
   },
 })
 ```
 
 **Privacy policies**:
 
-- `doNotTrackValue`: keeps the value of the field out of your analytics events. The
-  events carry the field ID only.
-- `doNotStoreValue`: stops the SDK, so that it does not put the value in browser
-  storage.
+- `doNotTrackValue`: set it to `false` to put the value of the field in your analytics
+  events. At `true`, and when the policy is absent, the events carry the field ID only.
+- `doNotStoreValue`: set it to `false` to let the SDK put the value in browser storage.
+  At `true`, and when the policy is absent, the SDK keeps the value out of storage.
 
-Use these policies for sensitive data such as a tax number, a credit card number, or
-a password. That data must stay in the browser.
+Both policies keep the value in the browser by default. A field with no `policies`
+object sends no value to your analytics and writes no value to browser storage. Keep
+the default for sensitive data such as a tax number, a credit card number, or a
+password. That data stays in the browser:
+
+```ts
+const sensitiveField = createField({
+  id: 'ssn',
+  name: 'ssn',
+  type: 'text',
+  label: 'Social Security Number',
+  multiple: false,
+  required: true,
+})
+```
 
-Neither policy stops the flow from the use of the value inside the page. A field with both
-policies set still holds its value there, for step validation and for the conditions after
-the step. The policies control what leaves the page: your analytics, and browser
+Neither policy stops the flow from the use of the value inside the page. A field that
+captures nothing still holds its value there, for step validation and for the conditions
+after the step. The policies control what leaves the page: your analytics, and browser
 storage.
 
 ## Field metadata