Files
search-with-chatgpt-powered…/docs/superpowers/specs/2026-10-18-amo-listing-design.md
T
golemandClaude Opus 5.5 12de8108a5 docs: record why the listing keeps "powered by OpenAI" and its own icon
OpenAI's brand guidelines forbid its logo on unofficial software and list the phrases allowed, of which the name uses "powered by OpenAI".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-18 23:55:55 -06:00

60 lines
2.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.