Merge branch 'main' into gwh-APIDOCS-2801-sample-apps-standardize-uid2

Author: genwhittTTD

docs/getting-started/gs-normalization-encoding.md

@@ -13,7 +13,7 @@ This page provides information about normalizing and encoding <Link href="../ref
 
 ## Introduction
 
-When you're taking user information such as an email address, and following the steps to create a raw UID2 and/or a UID2 advertising token, it's very important that you follow all the required steps. Whether you normalize the information or not, whether you hash it or not, follow the steps exactly. By doing so, you can ensure that the UID2 value you create can be securely and anonymously matched up with other instances of online behavior by the same user.
+When you're taking user information such as an email address, and following the steps to create a raw UID2 and/or a UID2 advertising token, it's very important that you follow all the required steps. Whether you normalize emails or not, and whether you hash emails and phone numbers or not, follow the steps exactly. By doing so, you can ensure that the UID2 value you create can be securely and anonymously matched up with other instances of online behavior by the same user.
 
 :::important
 - Raw UID2s, and their associated UID2 tokens, are case sensitive. When working with UID2, it's important to pass all IDs and tokens without changing the case. Mismatched IDs can cause ID parsing or token decryption errors.
@@ -71,10 +71,8 @@ For additional examples, see [Normalization Examples for Email](#normalization-e
 
 ## Phone Number Normalization
 
-If you send unhashed phone numbers to the UID2 Operator Service, the service normalizes the phone numbers and then hashes them. If you want to hash the phone numbers yourself before sending them, you must normalize them before you hash them.
-
 :::important
-Normalization before hashing ensures that the generated UID2 value will always be the same, so that the data can be matched. If you do not normalize before hashing, this might result in a different UID2, reducing the effectiveness of targeted advertising.
+You **must** normalize phone numbers before sending them in a request to the UID2 Operator Service, regardless of whether you apply hashing and encoding.
 :::
 
 Here's what you need to know about phone number normalization rules:
@@ -143,7 +141,7 @@ The tool does the following:
   - Hashed value
   - Base64-encoded value
 
-  :::note
+  :::important
   For phone numbers, you must first normalize the data.
   :::
 

docs/ref-info/updates-doc.md

@@ -11,6 +11,16 @@ import Link from '@docusaurus/Link';
 
 Check out the latest updates to our UID2 documentation resources.
 
+### New: Zoom-In Tool for Images
+
+December 15, 2024
+
+The UID2 docs site now includes a zoom-in tool for images.
+
+Just hover over the image and the tool appears as a magnifying glass... click to view a magnified version of the image.
+
+<!-- APIDOCS-2237 for both -->
+
 ### New: UID2 Portal Audit Trail Page
 
 November 15, 2024
@@ -333,11 +343,11 @@ These documents were further updated in later revisions. Updated links are as fo
 - [UID2 Client-Server Integration Guide for Prebid.js](../guides/integration-prebid-client-server.md)
 :::
 
-### New: Opt-Out
+### New: Opt-Out Page
 
 October 31, 2023
 
-This new "getting started" topic provides an overview of user opt-out.
+This new reference topic provides an overview of user opt-out.
 
 For details, see [User Opt-Out](../getting-started/gs-opt-out.md).
 

docusaurus.config.js

@@ -91,6 +91,7 @@ const config = {
         containerId: "GTM-K3NQMDX",
       },
     ],
+    require.resolve("docusaurus-plugin-image-zoom")
   ],
 
   presets: [
@@ -308,7 +309,17 @@ const config = {
         // apiKey: "58f35480017be37aca9f762323a0b4d1", //staging
         // indexName: "UID2", //staging
       },
+      zoom: {
+        selector: '.markdown :not(em) > img',
+        config: {
+          // options you can specify via https://github.com/francoischalifour/medium-zoom#usage
+          background: {
+            light: 'rgb(255, 255, 255)',
+            dark: 'rgb(50, 50, 50)'
+          }
+        }
+      }
     }),
-};
+  };
 
 export default config;

package-lock.json

@@ -26,6 +26,7 @@
     "@mdx-js/react": "^3.0.1",
     "@types/lodash": "^4.17.10",
     "clsx": "^2.1.1",
+    "docusaurus-plugin-image-zoom": "^2.0.0",
     "docusaurus-plugin-sass": "^0.2.5",
     "lottie-react": "^2.4.0",
     "prism-react-renderer": "^2.4.0",