profile

Eugene Yan

Some Paradoxical Rules of Writing

Published 7 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, I've been thinking a lot about leadership lately—what is it that makes some leaders so good that teams want to follow their lead? After some reflection, I came to three key points on leadership qualities, behaviors, and styles. Enjoy! I appreciate you receiving this, but if you want to stop, simply unsubscribe. • • • 👉 Read in browser for best experience (web version has extras & images) 👈 What makes an exceptional leader? Vision: They can foresee not only what will change, but...

about 1 month ago • 3 min read

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...

about 2 months 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...

2 months ago • 3 min read