diff --git a/README.md b/README.md
index daba65b..afaf354 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,25 @@
-# raphael-ai-notes
+# Illustrating technical documentation
 
-Prompt notes for Raphael AI, a free AI image generator - https://raphael.app
\ No newline at end of file
+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