Skip to content

Commit 45c597d

Browse files
committed
docs: rename the Record mode cursor row and the timeline tooltip labels
1 parent 5afc8fd commit 45c597d

3 files changed

Lines changed: 24 additions & 23 deletions

File tree

‎technical-documentation/engineering/tooltips.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ If the icon has to swap and the wording has to follow (Play, Pause), it is an ac
5858

5959
| | Limit |
6060
|---|---|
61-
| English text | 80 characters. 95 for the strings that define the two cursor modes |
61+
| English text | 80 characters. 95 for the strings that define the two cursor modes, and for Clear timeline, which has no confirmation and must say what goes and what stays |
6262
| Sentences | 2, one idea each. Punctuation at the end only when there are two |
6363
| Layout | `max-w-[260px]`, `dir="auto"`, balanced lines. 3 lines in English, 4 in French, Italian and Spanish |
6464
| Gap | 8px from the trigger. Where the trigger sits inside a padded surface (a button in the HUD bar), the gap is measured from that surface's edge |
@@ -80,9 +80,9 @@ If the icon has to swap and the wording has to follow (Play, Pause), it is an ac
8080
| Mode tabs | title "Media" on the text "Media" | no tooltip |
8181
| HUD record | "Display 1" (the source name) | "Start recording", then "Stop and save the recording" |
8282
| HUD cancel | "Cancel recording" (deletes it, no confirmation) | "Stop and delete this recording" |
83-
| Timeline | "Add zoom (Z)" | "Add a zoom at the playhead" and a chip |
83+
| Timeline | "Add zoom (Z)" | "Add a zoom at the current time" and a chip |
8484
| Timeline | "Auto-Focus on for all zooms, click to switch all to manual", changing with `aria-pressed` | name "Auto-Focus for all zooms", one tooltip |
85-
| Timeline | "Clear timeline" | "Remove all zooms, trims, speeds, annotations and Full Camera. Clips stay." |
85+
| Timeline | "Clear timeline" | "Remove all zooms, trims, speeds, annotations and Full Camera. Clips, audio and captions stay." |
8686
| HUD hide | "Hide recording bar" | add how to get it back: "Show it again from the tray icon." |
8787
| Chat | "Compact context" | "Summarize earlier messages to use less context" |
8888
| Segmented rows | every option has a title equal to its text | title only for an icon-only option |
@@ -113,7 +113,7 @@ One term per concept, across the HUD, Record mode and the editor. Where a locale
113113
| What the computer plays | **System audio** | computer audio, desktop audio | Gloss it once in the tooltip: "the sound your computer plays". |
114114
| The voice input | **Microphone** | mic | Never abbreviate in English. |
115115
| One recording session and its file | **Recording** | take, clip (a clip is a piece on the timeline), capture | "Take" is a code word (`discardRecordingId`). It does not appear in any UI string. |
116-
| The moving line on the timeline | **playhead** | current time marker, cursor | Also the reference for "add at the playhead". Never call it "cursor": the cursor is the mouse pointer. |
116+
| The moving line on the timeline | **playhead** | current time marker, cursor | Never call it "cursor": the cursor is the mouse pointer. In a tooltip write "at the current time", not "at the playhead": in pt-BR, ru and tr the word for playhead is the word for the mouse cursor. |
117117
| The editing window | **Studio** as the name of the HUD button, **the editor** in sentences | "Editor" as a button name | The HUD tooltip defines the name once: "Open Studio: the editor for your recordings". |
118118
| A region on the timeline | zoom, trim, speed change, annotation, Full Camera | segment, block, clip (for a region) | Same words as the region pills ("Zoom 1", "Trim 1"). |
119119
| Toggle position | on / off | enabled / disabled, active | Off is a state, not a verb: never "turn off" or "switch on". |

0 commit comments

Comments
 (0)