fix: Remove reference to by field (#284)

* Update MCP files description

* Remove reference to by field

* Update proguard troubleshooting guide (#281)

* PLuG user identification docs improvements (#279)

* PLuG user identification docs improvements

* address review comments

* diagram font

* Revert "diagram font"

This reverts commit 5af9512.

* diagram font

* Update fern/docs/pages/sdks/web/user-identity.mdx

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* Update fern/docs/pages/sdks/web/user-identity.mdx

Co-authored-by: Ben Colborn <[email protected]>

* update font

---------

Co-authored-by: Ben Colborn <[email protected]>
Co-authored-by: Atul-Butola <[email protected]>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* chore: update session ingestion URLs (#282)

* Nit

* Nit

* Update fern/docs/pages/airdrop/mcp.mdx

---------

Co-authored-by: Rohan Gupta <[email protected]>
Co-authored-by: Kunal Mohta <[email protected]>
Co-authored-by: Ben Colborn <[email protected]>
Co-authored-by: Atul-Butola <[email protected]>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Author: 6 people

fern/docs/pages/airdrop/mcp.mdx

@@ -16,11 +16,10 @@ Testing shows good results with Cursor and Claude Code. The AI can prepare initi
 - Chef-cli installed and configured
 - MCP-compatible client (Cursor, Claude Code, etc.)
 - External domain metadata file
-- Empty or partially populated initial domain mapping file
 
 ## Configuration
 
-Create a `.mcp.json` file with the following content:
+Create a `mcp.json` file with the following content:
 
 ```json
 {
@@ -38,7 +37,9 @@ Create a `.mcp.json` file with the following content:
 ### Cursor setup
 
 1. Provide `.cursor/mcp.json` in your project root.
-2. Using the editor Agent mode point the AI to the initial domain mapping file.
+2. Using the editor Agent mode point the AI to the preferred initial domain mapping file location. 
+    - For best results, mention that file paths should be absolute.
+    - Alternatively, you can provide an existing initial domain mapping file.
 3. Use the editor to guide the AI to create the initial domain mappings.
 4. Use `initial-mapping check` to test the initial domain mappings against the local domain metadata file.
 
@@ -51,7 +52,8 @@ See [Cursor documentation](https://docs.cursor.com/context/@-symbols/@-docs#add-
 ### Claude Code setup
 
 1. Provide `.mcp.json` in your project root.
-2. Using the editor point the AI to the initial domain mapping file.
+2. Using the editor point the AI to the preferred initial domain mapping file location.
+    - Alternatively, you can provide an existing initial domain mapping file.
 3. Use the editor to guide the AI to create the initial domain mappings.
 4. Use `initial-mapping check` to test the initial domain mappings against the local domain metadata file.
 
@@ -86,4 +88,3 @@ The MCP server provides tools for:
 - Field mapping and unmapping operations
 - Validation of mapping file structure
 - Testing initial domain mapping files against local metadata files
-

fern/docs/pages/airdrop/metadata-extraction.mdx

@@ -364,45 +364,12 @@ be changed by the end user at any time, such as mandatory fields or custom field
     }
     ```
 
-  - Some references have the role of parent or child.
+  Some references have the role of parent or child.
   This means that the child record doesn't make sense without its parent, for example a comment
   attached to a ticket.
   Assigning a `reference_type` helps Airdrop correctly handle such fields in case the end-user
   decides to filter some of the parent records out.
 
-  - Sometimes the external system uses references besides the primary key of records, for example
-  when referring to a case by serial number, or to a user by their email.
-  To correctly resolve such references, they must be marked with `by_field`, which must be a field
-  existing in that record type, marked `is_identifier`. For example:
-  ```json {7,16-20}
-  {
-    "record_types": {
-      "users": {
-        "fields": {
-          "email": {
-            "type": "text",
-            "is_identifier":true
-          }
-        }
-      },
-      "comments": {
-        "fields": {
-          "user_email": {
-            "type": "reference",
-            "reference": {
-              "refers_to": {
-                "#record:users": {
-                  "by_field": "email"
-                }
-              }
-            }
-          }
-        }
-      }
-    }
-  }
-  ```
-
   ### Define field attributes
 
   External system fields that shouldn't be mapped in reverse should be marked as `is_read_only`.