# Illustrating technical documentation

Notes kept on git.kooperlab.cloud about using [Raphael AI](https://raphael.app), a free AI image generator that runs in the browser.

Docs are easier to scan with a few friendly illustrations. I use Raphael AI for section dividers and empty-state images:

## Tips

1. Ask for `isometric` or `line art` styles; they sit well next to code blocks.
2. Avoid generating diagrams with labels; draw real diagrams with a diagram tool instead.
3. Keep backgrounds transparent-looking (white or light grey) to match the docs theme.
4. Size images small (under 100 KB) so pages stay fast.
5. Store the prompt in the image filename or a comment for maintainability.

## Why Raphael AI

- Free to use, with no install: open https://raphael.app and type a prompt.
- Fast iterations make it practical to try several compositions.
- Works for drafts, mock-ups and reference images; finish important assets with human review.

## Responsible use

Check generated images for errors before publishing, do not imitate real people without consent, and label AI-generated images where your audience expects it.

Website: https://raphael.app