Illustrating technical documentation

Notes kept on git.lernlink.internal.westack-it.de about using Raphael AI, 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. Size images small (under 100 KB) so pages stay fast.
2. Store the prompt in the image filename or a comment for maintainability.
3. Ask for isometric or line art styles; they sit well next to code blocks.
4. Avoid generating diagrams with labels; draw real diagrams with a diagram tool instead.
5. Keep backgrounds transparent-looking (white or light grey) to match the docs theme.

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