fix(i18n): describe session transfer as a one-time code, not a link (#8173)

The home-page settings dialog told users to copy and open a "link" to
transfer their "session", but the flow copies a bare one-time UUID that
has to be pasted into the Receive session tab, and only moves the author
token and pad preferences (not a login/Express session). Update the
English copy of the existing keys to describe the real code-based
workflow, its single-use/5-minute lifetime, and exactly what is moved.

Add a Playwright spec asserting the rendered strings.

Fixes #8173

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012kA75NPq8nGRidAwhPXeCi

Author: JohnMcLear

src/locales/en.json

@@ -219,16 +219,16 @@
   "index.settings": "Settings",
   "index.transferSessionTitle": "Transfer session",
   "index.receiveSessionTitle": "Receive session",
-  "index.receiveSessionDescription": "Here you can receive an Etherpad session from another browser or device. Please note, however, that this will delete your current session, if any.",
-  "index.transferSession": "1. Transfer session",
-  "index.transferSessionNow": "Transfer session now",
-  "index.copyLink": "2. Copy link",
-  "index.copyLinkDescription": "Click on the button below to copy the link to your clipboard.",
-  "index.copyLinkButton": "Copy link to clipboard",
-  "index.transferToSystem": "3. Copy session to new system",
-  "index.transferToSystemDescription": "Open the copied link in the target browser or device to transfer your session.",
+  "index.receiveSessionDescription": "Here you can receive your Etherpad author identity and preferences from another browser or device. Please note that this replaces the author identity currently used in this browser, if any.",
+  "index.transferSession": "1. Create a transfer code",
+  "index.transferSessionNow": "Create transfer code",
+  "index.copyLink": "2. Copy the transfer code",
+  "index.copyLinkDescription": "Click on the button below to copy the transfer code to your clipboard. The code can only be used once and expires after 5 minutes.",
+  "index.copyLinkButton": "Copy code to clipboard",
+  "index.transferToSystem": "3. Paste the transfer code",
+  "index.transferToSystemDescription": "Paste the transfer code you copied on the other browser or device into the field below.",
   "index.code": "Code",
-  "index.transferSessionDescription": "Transfer your current session to browser or device by clicking the button below. This will copy a link to a page that will transfer your session when opened in the target browser or device.",
+  "index.transferSessionDescription": "Move your Etherpad author identity (so your edits stay attributed to you) and your preferences to another browser or device. Click the button below to create a one-time transfer code, then paste the code into the receiving browser or device. Other data, such as sign-in sessions, is not transferred.",
   "index.createOpenPad": "Open pad by name",
   "index.openPad": "open an existing Pad with the name:",
   "index.recentPads": "Recent Pads",

src/tests/frontend-new/specs/session_transfer_copy.spec.ts

@@ -0,0 +1,56 @@
+import {expect, test} from '@playwright/test';
+
+// ether/etherpad#8173: the session transfer dialog used to tell users to
+// copy and open a "link", but the flow actually copies a one-time code that
+// has to be pasted into the "Receive session" tab of the other browser, and
+// it only moves the author identity and preferences, not a full login
+// session. These assertions check the rendered (localized) English copy
+// matches that behaviour.
+test.describe('session transfer dialog copy', () => {
+  test.beforeEach(async ({page}) => {
+    await page.goto('http://localhost:9001/?lang=en');
+    await page.locator('.settings-button').click();
+    await expect(page.locator('#settings-dialog')).toBeVisible();
+  });
+
+  test('transfer tab describes a code, not a link', async ({page}) => {
+    const description = page.locator('[data-l10n-id="index.transferSessionDescription"]');
+    await expect(description).toContainText('code');
+    await expect(description).toContainText('author identity');
+    await expect(description).not.toContainText('link');
+
+    await expect(page.locator('[data-l10n-id="index.transferSessionNow"]'))
+        .toHaveText('Create transfer code');
+
+    await page.route('**/tokenTransfer', (route) => route.fulfill({
+      status: 200,
+      contentType: 'application/json',
+      body: JSON.stringify({id: '12345678-1234-5678-1234-567812345678'}),
+    }));
+    await page.locator('[data-l10n-id="index.transferSessionNow"]').click();
+
+    const copySection = page.locator('#copy-link-section');
+    await expect(copySection).toBeVisible();
+    await expect(copySection.locator('[data-l10n-id="index.copyLink"]'))
+        .toHaveText('2. Copy the transfer code');
+    await expect(copySection.locator('[data-l10n-id="index.copyLinkDescription"]'))
+        .not.toContainText('link');
+    await expect(copySection.locator('[data-l10n-id="index.copyLinkButton"]'))
+        .toHaveText('Copy code to clipboard');
+  });
+
+  test('receive tab asks for the code to be pasted', async ({page}) => {
+    await page.locator('#button-bar button[data-l10n-id="index.receiveSessionTitle"]').click();
+    const receiveSection = page.locator('#transfer-to-system-section');
+    await expect(receiveSection).toBeVisible();
+    await expect(receiveSection.locator('[data-l10n-id="index.transferToSystem"]'))
+        .toHaveText('3. Paste the transfer code');
+    const description =
+        receiveSection.locator('[data-l10n-id="index.transferToSystemDescription"]');
+    await expect(description).toContainText('Paste');
+    await expect(description).not.toContainText('link');
+    await expect(receiveSection.locator('[data-l10n-id="index.receiveSessionDescription"]'))
+        .toContainText('author identity');
+    await expect(receiveSection.locator('#codeInput')).toBeVisible();
+  });
+});