gwh-APIDOCS-3914-change-heading-case by genwhittTTD · Pull Request #1010 · IABTechLab/uid2docs

genwhittTTD · 2026-04-15T19:43:38Z

Change all headings in the docs from heading case to sentence case, including h1 (using a Claude script).
includes YAML values.

ericwTTD · 2026-05-15T16:49:26Z


 1. [Create a clean room for UID2 collaboration](#create-clean-room-for-uid2-collaboration).
-1. [Send your Databricks sharing identifier to your UID2 contact](#send-sharing-identifier-to-uid2-contact).
+1. [Send your databricks sharing identifier to your UID2 contact](#send-sharing-identifier-to-uid2-contact).


uppercase "data bricks" here and elsewhere

Fixed, thx! There was one instance only (and none in EUID).

ericwTTD · 2026-05-15T16:51:56Z

 If your UID2s are not being passed through Google, make sure that you chose the correct Web Signal Deployment Method during setup.

-For details, see the **Important** note in [Allow Secure Signals Sharing](#allow-secure-signals-sharing).
+For details, see the **Important** note in [Allow Secure Signals sharing](#allow-secure-signals-sharing).


is "Secure Signals" a proper name?

@ericwTTD Yes it is. See https://unifiedid.com/docs/ref-info/glossary-uid#gl-secure-signals.

ericwTTD · 2026-05-15T16:58:36Z

 :::

-## Private Operator Benefits
+## Private Operator benefits


is "Private Operator" a proper noun?

Yes it is -- for UID2/EUID. Should be consistent throughout (and it is).
See https://unifiedid.com/docs/ref-info/glossary-uid#gl-private-operator

Also https://unifiedid.com/docs/ref-info/glossary-uid#gl-public-operator

ericwTTD · 2026-05-15T16:59:24Z

 <SnptUpgradePolicy />

-## Keeping the Operator Key Secure
+## Keeping the operator key secure


Is this related to "Private Operator?" Should it be reverted to uppercase?

Private Operator is initial cap for UID2/EUID but operator key is not. Probably the Public Operator has an operator key also (though I'm not sure about that).

I checked for consistency with EUID and this is consistent. No change here.

Update based on looking at glossary entries for you! Operator is initial cap in the glossary: https://unifiedid.com/docs/ref-info/glossary-uid#gl-operator

So... this is an inconsistency which I'd like to address, but not on this PR. This is consistent with EUID which SW reviewed. If you're OK with this I'll write a follow-up Jira for a clean sweep on this, for UID2 and EUID both. LMK. Thx much.

ericwTTD · 2026-05-15T17:01:18Z

+| Set `params.uid2Token` to the response body as a JavaScript object. | See [Client Refresh mode uid2Token example](#client-refresh-mode-uid2token-example) | You might choose to provide the response body via `params.uid2Token` in either of these cases:<ul><li>If you are already storing a lot of data in the cookie and adding the response body might exceed the cookie size limit.</li><li>If you prefer to have the Prebid module store the token value for you.</li></ul> |

-#### Client Refresh Mode Cookie Example
+#### Client Refresh mode cookie example


is "Client Refresh" a proper noun?

@ericwTTD Yes per SW senior UID2 Eng. This came from his edits on EUID therefore I believe yes. I had it the other way at first but this was one of the things I had to fix. There are two modes in this doc and both of them are initial cap: Client Refresh mode and Server-Only mode.

However -- I did a pass to check for consistent capitalization across all docs and found two instances in UID2, one in EUID, where it wasn't consistent. So this is in the updates. Thx.

ericwTTD · 2026-05-15T17:06:43Z

 | :--- | :--- | :--- |
 | `UID2_TOKEN` | TEXT | The value is one of the following:<ul><li>Encryption successful: The UID2 token containing the raw UID2.</li><li>Encryption not successful: `NULL`.</li></ul> |
-| `ENCRYPTION_STATUS` | TEXT | The value is one of the following:<ul><li>Encryption successful: `NULL`.</li><li>Encryption not successful: The reason why the raw UID2 was not encrypted. For example: `INVALID_RAW_UID2` or `INVALID NOT_AUTHORIZED_FOR_MASTER_KEY`.<br/>For details, see [Values for the ENCRYPTION_STATUS Column](#values-for-the-encryption_status-column).</li></ul> |
+| `ENCRYPTION_STATUS` | TEXT | The value is one of the following:<ul><li>Encryption successful: `NULL`.</li><li>Encryption not successful: The reason why the raw UID2 was not encrypted. For example: `INVALID_RAW_UID2` or `INVALID NOT_AUTHORIZED_FOR_MASTER_KEY`.<br/>For details, see [Values for the encryption_status column](#values-for-the-encryption_status-column).</li></ul> |


ENCRYPTION_STATUS should remain all caps?

Yes! Great catch. Fixed all instances. Doesn't exist in EUID. TYSM.

ericwTTD · 2026-05-15T17:07:12Z

 | `UID2` | TEXT | The value is one of the following:<ul><li>Decryption successful: The raw UID2 corresponding to the UID2 token.</li><li>Decryption not successful: `NULL`.</li></ul> |
 | `SITE_ID` | INT | The value is one of the following:<ul><li>Decryption successful: The identifier of the UID2 participant that encrypted the token.</li><li>Decryption not successful: `NULL`.</li></ul> |
-| `DECRYPTION_STATUS` | TEXT | The value is one of the following:<ul><li>Decryption successful: `NULL`.</li><li>Decryption not successful:  The reason why the UID2 token was not decrypted; for example, `EXPIRED_TOKEN`.<br/>For details, see [Values for the DECRYPTION_STATUS Column](#values-for-the-decryption_status-column).</li></ul> |
+| `DECRYPTION_STATUS` | TEXT | The value is one of the following:<ul><li>Decryption successful: `NULL`.</li><li>Decryption not successful:  The reason why the UID2 token was not decrypted; for example, `EXPIRED_TOKEN`.<br/>For details, see [Values for the decryption_status column](#values-for-the-decryption_status-column).</li></ul> |


DECRYPTION_STATUS should remain all caps in description?

Yes! Same thing: fixed 12 instances. Doesn't exist in EUID. TYSM.

ericwTTD · 2026-05-15T17:08:20Z

 | `UID`       | TEXT      | The value is one of the following:<ul><li>DII was successfully mapped: The UID2 associated with the DII.</li><li>DII was not successfully mapped: `NULL`.</li></ul>                                                                                                                                                               |
 | `BUCKET_ID` | TEXT      | The value is one of the following:<ul><li>DII was successfully mapped: The ID of the <Link href="../ref-info/glossary-uid#gl-salt-bucket">salt bucket</Link> used to generate the UID2. This ID maps to the bucket ID in the `SALT_BUCKETS` view.</li><li>DII was not successfully mapped: `NULL`.</li></ul>                                                                                  |
-| `UNMAPPED`  | TEXT      | The value is one of the following:<ul><li>DII was successfully mapped: `NULL`.</li><li>DII was not successfully mapped:  The reason why the identifier was not mapped: `OPTOUT`, `INVALID IDENTIFIER`, or `INVALID INPUT TYPE`.<br/>For details, see [Values for the UNMAPPED Column](#values-for-the-unmapped-column).</li></ul> |
+| `UNMAPPED`  | TEXT      | The value is one of the following:<ul><li>DII was successfully mapped: `NULL`.</li><li>DII was not successfully mapped:  The reason why the identifier was not mapped: `OPTOUT`, `INVALID IDENTIFIER`, or `INVALID INPUT TYPE`.<br/>For details, see [Values for the unmapped column](#values-for-the-unmapped-column).</li></ul> |


UNMAPPED should stay all caps?

Yes, TYSM. Fixed 4 instances. Doesn't exist in EUID.

ericwTTD · 2026-05-15T17:12:55Z

-#### Get the Principal ID of the Managed Identity
+#### Get the principal ID of the managed identity

 To get the Principal ID, run the following command, using your own values as needed:


lowercase "Principal?"

@ericwTTD thx! Agree, after some research: https://learn.microsoft.com/en-us/graph/utcm-authentication-setup#set-up-the-tcm-service-principal.

And done: one instance in each language, not applicable to EUID.

ericwTTD · 2026-05-15T17:14:31Z

 | Reloads `syslog-ng`. | `sudo /usr/sbin/syslog-ng-ctl reload` |

-## Keeping the Operator Key Secure
+## Keeping the operator key secure


should "operator" be uppercase?

@ericwTTD I think not. Made sure it's in sync with EUID which was very thoroughly reviewed by Eng, and it is.

Update: see my earlier response. This is a change we should make in UID2 and EUID to be consistent, and it affects more than headings. Targeted for a separate Jira if you're OK with that.

ericwTTD · 2026-05-15T17:14:45Z

 <SnptRotatingTheKeys />

-## UID2 Operator Error Codes
+## UID2 Operator error codes


should "Operator" be lowercase?

@ericwTTD See my previous comment. Consistent with EUID but should be addressed on a follow-up pass.

ericwTTD · 2026-05-15T21:43:16Z

   ```

-### Set Up the Gateway Load Balancer
+### Set up the gateway load balancer


in body text this is a proper noun?

Great catch. TYSM. Fixed in all instances.

ericwTTD · 2026-05-15T21:45:52Z

 To set up and configure the account that you created when you installed the gcloud CLI, complete the following steps. Replace the placeholder values with your own valid values.

-1. Switch to the project that you created in [Confidential Space Account Setup](#confidential-space-account-setup):
+1. Switch to the project that you created in [Confidential Space account setup](#confidential-space-account-setup):


is "Confidential Space" a proper noun?

@ericwTTD yes it is. See https://unifiedid.com/docs/ref-info/glossary-uid#gl-confidential-space.

ericwTTD · 2026-05-15T21:46:47Z

 :::

-#### Create Secret for the Operator Key in Secret Manager
+#### Create secret for the operator key in secret manager


is "secret manager" a proper noun?

Great catch, thank you. It is: https://cloud.google.com/security/products/secret-manager

Fixed, 6 instances.

ericwTTD · 2026-05-15T22:47:30Z

 November 2, 2023

-The Client-Side Integration Guide for Prebid.js is a completely new document at the existing URL, covering a way of integrating UID2 with Prebid that does not require any server-side work.
+The Client-side integration guide for Prebid.js is a completely new document at the existing URL, covering a way of integrating UID2 with Prebid that does not require any server-side work.


keep "Client" uppercase?

I think you're saying that Client should be lowercase here? Not sure.

Anyway this is a reference to a guide title, without a link on it. It's history. But what I did was apply italics on it, as we do elsewhere for the few references to a guide that are not actually links. So it's consistent.

This string does not exist in EUID.

ericwTTD · 2026-05-15T22:48:03Z

 <CustomTagsContainer tags="Guides, Mobile, SDKs">

-### IMA Mobile Plugin for Android
+### IMA mobile Plugin for Android


should "Plugin" also be lowercase?

Good point, TY!

I'd originally lowercased plugin in titles, but as a result of the EUID edits I initial capped it, per edits from the senior engineer, as a product name. But, looking at EUID, it's IMA Plugin for Android etc... not IMA mobile Plugin for Android, which looks weird re case and is also redundant.

The "xxx Plugin for xxx" naming is consistent across everything except these update announcements. With Plugin capitalized.

I updated these to remove the word "mobile" in the title here. There are no other instances.

ericwTTD · 2026-05-15T22:49:20Z

 <CustomTagsContainer tags="Infrastructure">

-### UID2 Website in Japanese
+### UID2 website in japanese


capitalize "Japanese"

Aargh great catch TYSM.

ericwTTD · 2026-05-15T22:53:35Z

 As a publisher, there are two ways to use the SDK for Java: 
-1. [**Basic Usage**](#basic-usage) is for publishers who want to use this SDK's HTTP implementation (synchronous [OkHttp](https://square.github.io/okhttp/)).
-2. [**Advanced Usage**](#advanced-usage) is for publishers who prefer to use their own HTTP library. 
+1. [**basic usage**](#basic-usage) is for publishers who want to use this SDK's HTTP implementation (synchronous [OkHttp](https://square.github.io/okhttp/)).


Uppercase "Basic"

Great catch thx. Done, but also I removed the formatting on the link. And the same issue existed in EUID so I fixed that too.

ericwTTD · 2026-05-15T22:53:46Z

-2. [**Advanced Usage**](#advanced-usage) is for publishers who prefer to use their own HTTP library. 
+1. [**basic usage**](#basic-usage) is for publishers who want to use this SDK's HTTP implementation (synchronous [OkHttp](https://square.github.io/okhttp/)).
+2. [**advanced usage**](#advanced-usage) is for publishers who prefer to use their own HTTP library. 



Uppercase "Advanced"

Yep fixed as above. TYSM.

ericwTTD · 2026-05-15T23:10:00Z

@@ -24,10 +24,10 @@ The Trade Desk (現在の UID2 Administrator) とすでに取引関係がある

 | Your Role | Contact Email |
 | :--- | :--- |
-| パブリッシャー、アプリ開発者 | [UID2publishers@thetradedesk.com](mailto:UID2publishers@thetradedesk.com) |
-| 代理店、ブランド、DSP、SSP、Customer Data Platform (CDP)、データプロバイダー | [UID2partners@thetradedesk.com](mailto:UID2partners@thetradedesk.com) |
+| パブリッシャー、アプリ開発者 | [Uid2publishers@thetradedesk.com](mailto:UID2publishers@thetradedesk.com) |


ericwTTD · 2026-05-15T23:10:10Z

-| パブリッシャー、アプリ開発者 | [UID2publishers@thetradedesk.com](mailto:UID2publishers@thetradedesk.com) |
-| 代理店、ブランド、DSP、SSP、Customer Data Platform (CDP)、データプロバイダー | [UID2partners@thetradedesk.com](mailto:UID2partners@thetradedesk.com) |
+| パブリッシャー、アプリ開発者 | [Uid2publishers@thetradedesk.com](mailto:UID2publishers@thetradedesk.com) |
+| 代理店、ブランド、DSP、SSP、Customer Data Platform (CDP)、データプロバイダー | [Uid2partners@thetradedesk.com](mailto:UID2partners@thetradedesk.com) |


revert email address?

ericwTTD · 2026-05-15T23:13:55Z


-この条件を満たす必要がある場合、または質問がある場合は、[UID2partners@thetradedesk.com](mailto:UID2partners@thetradedesk.com) までお問い合わせください。
+この条件を満たす必要がある場合、または質問がある場合は、[Uid2partners@thetradedesk.com](mailto:UID2partners@thetradedesk.com) までお問い合わせください。


revert email formatting?

ericwTTD · 2026-05-15T23:35:24Z

@@ -80,9 +80,9 @@ Server-Side SDK を使用している場合、SDK はエンドポイントに関
 1. [Establish identity: capture user data](#establish-identity-capture-user-data)
 2. [Bid using a UID2 token](#bid-using-a-uid2-token)
 3. [Refresh a UID2 token](#refresh-a-uid2-token)
-4. [Clear Identity: user logout](#clear-identity-user-logout)
+4. [Clear identity: user logout](#clear-identity-user-logout)


uppercase "user?"

ericwTTD · 2026-05-15T23:36:21Z

@@ -136,9 +136,9 @@ DII が電話番号の場合、UID2 [電話番号正規化](../getting-started/g
 | :--- | :--- | :--- |
 | `UID2`      | TEXT | DII は正常にマッピングされました: <br/>DII は正常にマップされませんでした: `NULL`。 |
 | `BUCKET_ID` | TEXT | DII は正常にマップされました: UID2 の生成に使われたセカンドレベルのソルトバケットの ID。この ID は `UID2_SALT_BUCKETS` ビューのバケット ID に対応します。<br/>DII は正常にマップされませんでした: `NULL`。 |
-| `UNMAPPED`  | TEXT | DII は正常にマッピングされました: `NULL`<br/>DII は正常にマップされませんでした: `NULL`:  DII は正常にマップされませんでした: 識別子がマップされなかった理由: `OPTOUT`、`INVALID IDENTIFIER`、`INVALID INPUT TYPE` のいずれか。詳細は [Values for the UNMAPPED Column](#values-for-the-unmapped-column) を参照してください。 |
+| `UNMAPPED`  | TEXT | DII は正常にマッピングされました: `NULL`<br/>DII は正常にマップされませんでした: `NULL`:  DII は正常にマップされませんでした: 識別子がマップされなかった理由: `OPTOUT`、`INVALID IDENTIFIER`、`INVALID INPUT TYPE` のいずれか。詳細は [Values for the unmapped column](#values-for-the-unmapped-column) を参照してください。 |


Revert "unmapped" before "column?"

ericwTTD · 2026-05-15T23:41:02Z

@@ -8,7 +8,7 @@ displayed_sidebar: docs

 import Link from '@docusaurus/Link';

-# UID2 GMA Plugin for Android Integration Guide
+# UID2 GMA Plugin for Android integration guide


lowercase "Plugin?"

ericwTTD · 2026-05-15T23:44:58Z

@@ -156,7 +156,7 @@ Key Vault を作成したら、[managed identity](https://learn.microsoft.com/en
   | Parameter | Description |
   | :--- | :--- |
   | `vaultName` | Operator Key シークレットをホストするための Key Vault の名前。選択する名前はグローバルに一意である必要があります。 |
-   | `operatorKeyValue` | アカウント設定の一環として UID チームから受け取った `OPERATOR_KEY` シークレット値 ([Set Up UID2 Operator Account](#set-up-uid2-operator-account) を参照)。この値はあなたに固有であり、パスワードとして機能します。安全で秘密に保つ必要があります。 |
+   | `operatorKeyValue` | アカウント設定の一環として UID チームから受け取った `OPERATOR_KEY` シークレット値 ([Set up UID2 Operator account](#set-up-uid2-operator-account) を参照)。この値はあなたに固有であり、パスワードとして機能します。安全で秘密に保つ必要があります。 |


capitalize "Operator?"

ericwTTD · 2026-05-15T23:56:56Z

@@ -749,84 +749,84 @@ SDK for JavaScript Version 3 の機能強化に伴い、ドキュメントが大

 <CustomTagsContainer tags="Guides, Private Operator">

-### Private Operator Guide for Google Confidential Space 
+### Private Operator guide for Google confidential space 


uppercase "Confidential Space?"

ericwTTD · 2026-05-15T23:59:13Z


 パブリッシャーとして、SDK for Java を使用するには 2 つの方法があります: 
-1. [**Basic Usage**](#basic-usage) は、この SDK の HTTP 実装 (synchronous [OkHttp](https://square.github.io/okhttp/)) を使いたいパブリッシャー向けです。
-2. [**Advanced Usage**](#advanced-usage) は、独自の HTTP ライブラリを使用したいパブリッシャー向けです。
+1. [**basic usage**](#basic-usage) は、この SDK の HTTP 実装 (synchronous [OkHttp](https://square.github.io/okhttp/)) を使いたいパブリッシャー向けです。


capitalize "basic?"

ericwTTD · 2026-05-15T23:59:25Z

-1. [**Basic Usage**](#basic-usage) は、この SDK の HTTP 実装 (synchronous [OkHttp](https://square.github.io/okhttp/)) を使いたいパブリッシャー向けです。
-2. [**Advanced Usage**](#advanced-usage) は、独自の HTTP ライブラリを使用したいパブリッシャー向けです。
+1. [**basic usage**](#basic-usage) は、この SDK の HTTP 実装 (synchronous [OkHttp](https://square.github.io/okhttp/)) を使いたいパブリッシャー向けです。
+2. [**advanced usage**](#advanced-usage) は、独自の HTTP ライブラリを使用したいパブリッシャー向けです。


capitalize "advanced?"

gwh-APIDOCS-3914-change-heading-case add js+bat+modify gitignore

249b829

genwhittTTD marked this pull request as draft April 15, 2026 19:44

genwhittTTD added 24 commits April 22, 2026 16:19

Merge branch 'main' into gwh-APIDOCS-3914-change-heading-case

cd8eed3

gwh-APIDOCS-3914-change-heading-case test

8153eb4

remove 2 new files

8171ce2

Change all MD headings to sentence case

9e37922

revert mods

29e9d15

update sidebars.js

577d5c2

Merge branch 'main' into gwh-APIDOCS-3914-change-heading-case

f1224ed

update sidebars.js

baf6af5

change case on headings

b5d0ae0

refresh from main, fix merge conflicts

85ca3ad

ran capitalization script again, plus fixes

9af9f24

additional mods based on GWH/C review

eedff3e

additional mods based on GWH/C review #2

9ab0672

additional GWH/C edits from comare of UID2 and EUID PRs

5213ff9

mods to YAML metadata (partial)

6fc7e3d

mods to YAML metadata, more

eb812d6

mods to YAML metadata, many more

8bd6226

mods to YAML metadata, rest of EN-US

d676c15

additional YAML mods

3bcae75

fix couple YAML inconsistencies

b6330de

updates to JA title, sidebar, pagination YAML GWH/C

4da7271

GWH/C title fix

9e22332

add sidebar label for consistency with EUID

b723614

GWH/C mods

62e9e0c

genwhittTTD marked this pull request as ready for review May 11, 2026 16:21

genwhittTTD added 2 commits May 12, 2026 09:58

Merge branch 'main' into gwh-APIDOCS-3914-change-heading-case

3e0168d

sidebar fixes for consistency

3b2882d

miyaichi mentioned this pull request May 13, 2026

Jpn translation update 1003 1015 #1020

Open

ericwTTD reviewed May 15, 2026

View reviewed changes

Sentence case edits from EW #1

706e4ea


		この条件を満たす必要がある場合、または質問がある場合は、[UID2partners@thetradedesk.com](mailto:UID2partners@thetradedesk.com) までお問い合わせください。
		この条件を満たす必要がある場合、または質問がある場合は、[Uid2partners@thetradedesk.com](mailto:UID2partners@thetradedesk.com) までお問い合わせください。

Conversation

genwhittTTD commented Apr 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

genwhittTTD May 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

genwhittTTD May 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

genwhittTTD May 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

genwhittTTD May 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

genwhittTTD May 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

genwhittTTD May 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

genwhittTTD commented Apr 15, 2026 •

edited

Loading

genwhittTTD May 18, 2026 •

edited

Loading

genwhittTTD May 18, 2026 •

edited

Loading

genwhittTTD May 18, 2026 •

edited

Loading

genwhittTTD May 18, 2026 •

edited

Loading

genwhittTTD May 18, 2026 •

edited

Loading

genwhittTTD May 18, 2026 •

edited

Loading