# Add-ons listing for 1.3

Status: implemented on `docs/24-amo-listing-add-screenshots-and-a` (#24). The
paste-ready text and captions are in [`docs/amo/`](../../amo/README.md), along
with the page that renders the images.

## Problem

The AMO listing had no screenshots, and its description covered only the `gpt`
keyword. It never mentioned right-click, the keyboard shortcut, or the toolbar
button. The listing is where newcomers decide to install and first learn how to
use the extension.

## Decisions

- **Tone: clear, with one joke.** The copy gives plain steps for newcomers. A
  general cat joke ("gpt why does my cat knock things over?") replaces the old
  programmer joke ("sudo make me a sammich"), and the images share the cat
  theme.
- **Say it is small.** Customization without bloat is what sets this extension
  apart, so the description has a "Small on purpose" section: about 56 KB, no
  libraries, no server, no API key, no intermediary, and nothing reported to
  us. These are the README's privacy claims; nothing new is claimed.
- **Drawings as screenshots.** The images are the options page's drawings,
  enlarged and rendered by headless Firefox:
  - They are part of the extension's own UI.
  - They stay sharp and on brand.
  - They can be regenerated after UI changes.

  Real screenshots would show OS-specific menus and go stale. A real
  screenshot of the options page is suggested as a sixth image, taken by the
  maintainer, because one genuine screenshot builds trust in the rest.
- **AMO's guidance.** Images are 1280×800, the size AMO recommends and its
  largest display size, and carry no added text. Explanations go in each image's
  caption.
- **The copy rule holds.** ChatGPT opens with the text filled in; it is never
  sent, searched, or asked. Temporary chat and web search are described as
  hints, and "private", "incognito", and "secure" appear nowhere near temporary
  chat.
- **Branding stays.** The name's "powered by OpenAI" and the extension's own
  icon follow OpenAI's brand guidelines: no OpenAI logo on unofficial software,
  and only the phrases the guidelines allow. The description's "unofficial"
  line complements them.
- **Correction from the draft.** The description does not say ChatGPT opens "in
  a new tab": `gpt` searches open in the current tab, and the other ways follow
  the Open ChatGPT in setting.

## Files

- `docs/amo/README.md`: summary, description (Markdown, which AMO has used
  instead of HTML since March 2025), captions in
  upload order, and how to regenerate the images.
- `docs/amo/screenshots.html`: the drawing markup at 1280×800, one image per
  `#fragment`, styled by `options/options.css`.
- `docs/amo/screenshots/*.png`: the five rendered images. They are generated
  and git-ignored rather than committed, so the repository carries no binaries
  and needs no Git LFS. The command to produce them is in the README.

`docs/` is excluded from the extension package, so none of this ships to users.