# WP.org Screenshot Capture Runbook (Free Release)

Use this runbook to produce consistent screenshots for the WordPress.org plugin page.

## Output files

Create these files in local order:

1. screenshot-1.png
2. screenshot-2.png
3. screenshot-3.png
4. screenshot-4.png
5. screenshot-5.png

## One-time setup

1. Start from a clean WordPress admin session.
2. Set admin language to English.
3. Disable unrelated admin notices if possible.
4. Use browser zoom 100%.
5. Use a fixed viewport for all screenshots (recommended 1440x900).

## Content safety rules

1. Do not expose personal data.
2. Do not expose tokens, API keys, or internal URLs.
3. Use realistic sample post content only.
4. Keep the same visual density across screenshots.

## Capture flow

### Screenshot 1 - Settings page

Path: Settings > Nomad Pipeline Audio to Draft

Required visible elements:
- Default language
- Default tone
- Default target length
- Default proper noun hints
- Default insertion mode
- Auto-apply generated title

Framing:
- Include page title and settings table.
- Exclude unrelated plugins/notices when possible.

Save as: screenshot-1.png

### Screenshot 2 - Gutenberg sidebar ready state

Path: Posts > Add New (Block Editor)

Required visible elements:
- Nomad Pipeline Audio to Draft sidebar open
- Selected audio file visible
- Generate draft action visible
- Editorial options visible with sane defaults

Framing:
- Sidebar and enough editor area to show context.
- No sensitive post metadata.

Save as: screenshot-2.png

### Screenshot 3 - Generated result in editor

Path: Same post after generation

Required visible elements:
- Generated heading block
- Generated paragraph blocks
- Generated list block (if present)

Framing:
- Keep text readable at plugin page scale.
- Show that content is inserted in the current post editor.

Save as: screenshot-3.png

### Screenshot 4 - Media Library modal

Path: Block Editor sidebar -> Select audio -> Media Library modal

Required visible elements:
- Media Library modal open
- Audio item(s) visible with clear filename/type
- Selection action visible

Framing:
- Keep only relevant media metadata visible.
- Avoid personal filenames if they are sensitive.

Save as: screenshot-4.png

### Screenshot 5 - Error message state

Path: Same sidebar, captured during a provider/runtime failure

Required visible elements:
- Error message block visible in sidebar
- Message text readable (helpful for troubleshooting)

Framing:
- No API keys, token values, account IDs, or private URLs.

Save as: screenshot-5.png

## Final QA before upload

1. File order and names are exact (screenshot-1/2/3/4/5.png).
2. Captions in readme.txt match the images.
3. Resolution and aspect ratio are consistent.
4. No privacy leaks or internal identifiers.
5. UI language is English.

## Optional compression

If PNG files are very large, apply lossless compression before upload.
Do not reduce clarity of labels and key UI text.
