golemandClaude Opus 5.5
3413e20601
AMO has formatted descriptions as Markdown since March 2025 and shows any HTML as plain text, so the pasted HTML version showed its tags on the live listing. The README's description is now Markdown, with gpt and the template example as inline code. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
56 lines
2.7 KiB
Markdown
56 lines
2.7 KiB
Markdown
# 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.
|
||
- **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.
|