CotranslatorAI

Always refer to CotranslatorAI by its full name in public writing. It can also be referred to more generically as an application (when talking about the program itself), a tool (especially for marketing copy), and app (colloquially in live presentations).

Elements of the UI

  • window – major section of the program contained in a Windows “window” container, currently: main window, Prompt Library window, Options window, Token Counter window
  • field – section of a window in which text can be entered
  • pane – section of a window with dynamic text which is only displayed
  • folder/subfolder – where prompts are kept
  • button – clickable UI element
  • drop-down menu – clickable UI element that drops down a selection of choices
  • menu item – item in a menu
  • grid – section of the main UI on which the AI dialogue history is displayed
  • settings – prompt characteristics that can be set at the global level (through the Options window) or the prompt level (using “prompt setting lines”) to control AI behavior.
  • prompt file – contain prompt text (Instructions field text only), along with “prompt setting lines”, if any.

Prompts

There are two kinds of prompts in CotranslatorAI: structured prompts (begin a new AI dialogue context window every time) and ad-hoc prompts (start a new AI dialogue context window (if none exists) or continue within the current AI dialogue context window. Prompts contain text (both Instructions text and Segment text, which are sent to the AI together (Instructions text first; Segment text second). Though the Instructions text and Segment text are shown separately in the AI dialogue history grid, they are processed as a seamless unit by the AI.

Bringing a prompt from the Prompt Library to the Instructions field is referred to as “loading the prompt” in CotranslatorAI. And submitting a prompt to the AI is referred to as “sending to the AI”.

AI dialogue and context

One or more interactions with the AI are referred to as an “AI dialogue” (within one context window) or “AI dialogues” (spanning more than one context window). AI dialogues are shown in the AI dialogue grid, and each AI dialogue can be made up of a structured prompt (containing instructions text and segment text) and AI output, an ad-hoc prompt and AI output, or a a structured prompt and AI output combined with one or more ad-hoc prompts and AI outputs.

A context window is a self-contained, discrete content block that the AI model has or can treat as a unit. In writing, we might refer to the “current AI dialogue context” or the “AI dialogue context window”.

Keyboard shortcuts

“Keyboard shortcuts” is the preferred term for key combinations that run prompts in different ways, and just using the word “shortcut” should be avoided. When being specific about the types of keyboard shortcuts supported in CotranslatorAI, there are “keyboard shortcuts assigned to built-in commands” (pre-set keyboard shortcuts that run the prompt currently loaded in the Structured Prompt fields) and “keyboard shortcuts assigned to prompts in the prompt library” (user-customizable shortcuts links to prompts).

Codes

The code new users receive from us when downloading and registering the software is called the “CotranslatorAI registration code” and the code they need to get from OpenAI and enter into CotranslatorAI to interface with the OpenAI models is called the “OpenAI API key”.

Writing style

With the exception of the “main window”, specific elements of the UI should be capitalized. For example: Prompt Library window, Instructions field, Send button, etc.