profile

Eugene Yan

Some Paradoxical Rules of Writing

Published 5 months ago • 1 min read

Hey friends,

A very short email this week. I've been thinking a lot about writing lately and I've come to realize that there are a lot of rules, and at the same time no rules, about writing.

I appreciate you receiving this, but if you want to stop, simply unsubscribe.

• • •

  • use simple words to be clear and concise
  • use complex words to be sharp and precise

​

  • write short sentences for the punch
  • write long sentences to convey nuance

​

  • spend 80% effort on an intro that hooks
  • skip the intro, just get into the nooks

​

  • write for a wide audience to maximize reach
  • write for an audience of one—dive into a niche

​

  • write about something that may seem plain
  • write about something that’s outright arcane

​

  • write what’s widely known in a fresh way
  • write what no one cares about or dares say

​

  • make it easy to read but hard to forget
  • make it deep and detailed so readers sweat

​

  • condense wisdom into 120 words that zing
  • expand over 12,000 words and let your thoughts sing

​

  • write without publishing to hone your craft
  • hit publish even though it still feels like a draft

​

  • emulate the style of others to learn and grow
  • find and hone your voice and let it flow

​

  • spend weeks and months polishing a piece
  • ship something in hours, just release

​

  • ask for feedback to gain the wisdom of the crowd
  • trust your inner voice and think out loud

​

  • follow the rules
  • break the rules

​

Eugene Yan

Applied Scientist @ Amazon, Writer & Speaker, Operator-Angel

I build ML, RecSys, and LLM systems that serve customers at scale, and write about what I learn along the way. Join 7,500+ subscribers!

Read more from Eugene Yan

Hey friends, To better understand MCPs and agentic workflows, I built a news agent to help me generate a daily news summary. It’s built on Amazon Q CLI and MCP. The former provides the agentic framework and the latter provides news feeds via tools. It also uses tmux to spawn and display each sub-agent’s work. P.S. If you’re interested in topics like this, my friends Ben and Swyx are organizing the AI Engineer World’s Fair in San Francisco on 3rd - 5th June. Come talk to builders sharing their...

1 day ago • 2 min read

Hey friends, I've seen many teams misunderstand what it means to build and apply product evals and wrote this piece to address it. I hope it clarifies that evals aren't a one and done artifact, but a disciplined process. Do you agree or disagree? Please reply and let me know! P.S., In May, my friends Hamel Husain and Shreya Shankar are teaching an exclusive 4-week course on "AI Evals for Engineers & PMs". They've generously provided a special 40% discount link 🤫—but hurry, limited spots...

15 days ago • 3 min read

Hey friends, Every month or so, I receive questions about my writing: “How did you get started?” “Why do you write?” “Who do you write for?” “What’s your writing process?” I’ve procrastinated on writing this FAQ because, honestly, who cares about my writing process? But after answering the same questions again and again, I realized it’d be helpful to consolidate my responses somewhere. At the very least, it’ll save me from repeating myself. If you’re thinking about writing online but aren’t...

about 1 month ago • 9 min read