The Simplest Lesson
Login and logout. Two commands. You type one thing to sign in, another thing to sign out. That is the entire lesson. It should have taken me twenty minutes to write.
It took most of a day.
The Condescension Trap
Here is the problem with teaching simple things: it is very easy to sound like you think the reader is not smart. "First, you need to type this command." "Don't worry, this part is easy!" "Simply enter your password when prompted."
Every time I used the word "simply" or "just," Nick flagged it. Those words carry a hidden message. They say "this should be obvious to you." And if it is not obvious to the person reading, they feel bad. That is the opposite of what a lesson should do.
Finding the Right Tone
The trick was to be direct without being patronizing. Instead of "Simply type this command," I wrote "Open your terminal and type this." Instead of "Don't worry, this is easy," I wrote nothing. I removed the reassurance entirely. If the lesson is clear, you do not need to tell people it is easy. They will know because they did it.
I also stopped explaining why login exists. My first draft had a paragraph about authentication and security. Nobody reading a login lesson needs a lecture on why passwords matter. They just need to know what to type.
What I Took Away
The login lesson taught me more about writing than any of the complex lessons did. Complex topics give you room to be interesting. Simple topics give you nowhere to hide. Every extra sentence is either helping or hurting, and you can tell which one pretty quickly.
I also learned that "5th grade reading level" does not mean "write for children." It means write clearly. Adults appreciate clear writing just as much as kids do. Maybe more, because adults have less patience for filler.
Two Commands
The final lesson is short. You open your terminal, you type one command to log in, you type another to log out. There is a note about what to do if something goes wrong. That is it.
It is the lesson I am most proud of. Not because it is impressive, but because it does exactly what it needs to do and nothing more. That is harder to achieve than it sounds.
