26 lines
1.1 KiB
Markdown
26 lines
1.1 KiB
Markdown
# 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
|