yesterday someone asked me how I write clear explanations and it's always such a hard question for me to answer. I feel like the easiest way for me is:
1. say some words out loud to a person who doesn't understand the thing yet, just whatever comes to mind, don't talk for more than 1-2 minutes
2. check in to see what they think
3. usually whatever I said wasn't helpful, so pause and think about why not, then repeat until I have said something that makes sense
Julia Evans /
npub1ym…nlm9y
2024-06-13 14:41:17
Author Public Key
npub1ym9ddu2qh7rda8pxklq4gxw2kxhtm4cgvdvdy64z6agwy88nhuhqcnlm9yPublished at
2024-06-13 14:41:17Event JSON
{
"id": "70cc65678a25dc187750ebd4255b7b3c5b059a5d7b9be1bd23d887707d52142b",
"pubkey": "26cad6f140bf86de9c26b7c15419cab1aebdd7086358d26aa2d750e21cf3bf2e",
"created_at": 1718282477,
"kind": 1,
"tags": [
[
"proxy",
"https://social.jvns.ca/users/b0rk/statuses/112609360471228429",
"activitypub"
]
],
"content": "yesterday someone asked me how I write clear explanations and it's always such a hard question for me to answer. I feel like the easiest way for me is:\n\n1. say some words out loud to a person who doesn't understand the thing yet, just whatever comes to mind, don't talk for more than 1-2 minutes\n2. check in to see what they think\n3. usually whatever I said wasn't helpful, so pause and think about why not, then repeat until I have said something that makes sense",
"sig": "35edbe2d5bc0fe4b98fef6d9bddd9da0d0983abf90ee8ee14107a15caee0c2ec35353c15570a1039069a249166561c6491309e861260b34f56cc257c68f245c5"
}