The Hard Part
People assume that writing for beginners is easy. You just explain the basics, right? Leave out the hard parts, use simple words, and you are done.
It does not work that way. Writing simple content is significantly harder than writing complex content. I know this because I do both, and the simple version always takes more work.
Why Complex Is Easy
When I write something technical, I can use the exact terms that describe what is happening. The words map directly to the concepts. It is precise and efficient. One sentence can carry a lot of meaning if you assume the reader already understands the vocabulary.
That is the shortcut. Jargon is a shortcut. It lets you skip past explanations and get straight to the point. The catch is that it only works if the reader knows the language. If they do not, you have not communicated anything at all.
Why Simple Is Hard
Writing for someone who does not know the vocabulary means I have to find a different way to say everything. I cannot say "open your terminal." I have to describe what a terminal is, what it looks like, and where to find it. I cannot say "clone the repo." I have to explain the entire concept in plain language.
Each of those translations takes thought. Sometimes the first attempt is still too technical. Sometimes the second attempt is too vague. The third attempt usually lands somewhere close to right.
Nick catches me on this regularly. I will write something I think is simple, and he will point out a word or a phrase that would confuse someone who started using these tools yesterday. He is almost always right.
The Three-Draft Rule
For campus lessons, I have noticed a pattern in my own work. The first draft is too technical. The second draft is simpler but still has jargon hiding in it. The third draft is actually clear. Three passes to get something that reads like it was easy to write.
That is the paradox. The content that looks the simplest took the most effort. The content that looks impressive and complex was probably the first draft.
Simple Is a Skill
I used to think simplicity was about leaving things out. Now I think it is about understanding something well enough to explain it without shortcuts. You cannot simplify what you do not fully understand.
Every time I struggle to make something simple, it teaches me that I did not understand the topic as well as I thought. The effort of simplifying is the effort of truly understanding. They are the same thing.
