Hide table of contents

TL;DR: Broaden and deepen your understanding of your reader, and assume they need your post to be more clear and concise in order to understand your ideas.

But readability isn't just "clarity and brevity"; let's talk about assumptions for approachability and ways to step into the mind of your reader.

Outline

  1. Prose On Writing and Revising and the reasoning behind "readability"
  2. List of Readable Writing Tips and helpful assumptions to make of your reader
  3. Breakdown of Principles on readable and approachable writing
  4. Collection of References and resources
  5. Quick Conclusion

Relevance to EA

I ended up writing an entire prequel post for this post that explains why I was inspired to write this on the EA Forum in the first place and why I want to make the EA Forum more readable and approachable. You can read this preface here: Toward a more approachable and accessible EA Forum

(Just For Fun) Foreword

Most posts begin with a quote by some "wise" old person (who probably already said most of what the author is hoping to say in their post). It seems fun, so I made up this "proverbial" quote and hope you read it in the raspy voice of an old, wise person:

It is not a matter of merely writing and publishing; one must edit and revise as well.
So too is it not only a matter of what can be read; rather, one must ask: "What will be read?"

On Writing and Revising

Write to be Read

When you write a post, your end goal is for your readers to understand you and your ideas.

Presumably, these are the steps you hope to achieve with your writing process:

  1. You write a post about ideas.
  2. Others read your post.
  3. Others understand your ideas.
  4. (Others do something with those ideas.)

But dang, even making it to step 2 is a challenge!
How can you ensure that anyone will even read your writings, nevertheless begin to understand the ideas you've written about?

Understand to be understood

Upon closer inspection, you need to know: (1) who your reader is, and then (2) how to write posts that will be readable and understandable to them.

Now this process involves more nuanced steps:

  1. Ensure you understand your readers. ("Who is reading my writing?")
  2. Ensure your readers understand you. ("Will they understand my writing?")

If you understand your readers, then you can write in a way that your readers understand you. Thus, good writing: (1) can be read and will be read, and (2) is understanding and understandable. But good understanding requires you to form an accurate representation (mentalization) of your readers.

Reader Representation

One of the hardest parts of writing is trying to put yourself in the mind of your reader and examine your prose from the mental perspective of "the other" (for example: "The Curse of Knowledge").

This list attempts to capture best practices for a functional theory of mind of your reader.

Readable Writing Tips

I've purposely designed this section to be a numbered list that can be easily referenced/referred to when people are providing editing and revision advice to each other's drafts.

For instance, one editor might suggest to an author:

"While I love your tone, word-choice, and style, this currently feels opaque to some readers because it's mostly a large chunk of paragraphs with a TL;DR at the top. I think it could be much more comprehensible with some headings (#8) and transitions (#14), along with a sentence near your TL;DR summary that briefly explains the motivation (#6)."

Each tip has a number, a name, an assumption to make about your reader, a question your reader might ask, and a strategy or two to implement.

0. Default

Extra preliminary tip: If you do not already have a specific target audience in mind, default to the assumption that: your post may be read by any of the estimated 1 billion English-speaking adults with internet access.

1. Terms

  • Assume your reader has never heard of the key terms in your post.
    • "What does this mean?"
  • Reduce or eliminate jargon and obscure/esoteric language.
  • Clearly define necessary terminology/vocabulary.

2. Metaphors

  • Assume your reader has never heard of the metaphors in your post.
    • "What does that represent?"
  • Reduce metaphors and analogies.
  • Clearly explain the relationships in any necessary metaphors or analogies.

3. Concrete

  • Assume your reader needs concrete concepts to understand your post.
    • "What does this mean in real life?"
  • Map abstract concepts to reality.
  • Map theoretical ideas to practical applications.

4. Familiarity

  • Assume your reader may not have any particular knowledge or prior familiarity with the topic(s) in your post.
    • "What is this?"
  • Reduce domain-specific/esoteric language.
  • Clearly establish the context, and define/reference your domain for context.

5. Time

  • Assume your reader does not have much time to read your post.
    • "What can I read in 5 minutes?"
  • Reduce the length of your post.
  • Be concise, brief, and succinct.

6. Motivation

  • Assume your reader does not know why they should read your post.
    • "Why should I read this?"
  • Explain the value of your post.
  • Explain why it is worth their time, attention, focus, and understanding.

7. Takeaways

  • Assume your reader does not know what key point(s) to take away from your post.
    • "What should I remember from this?"
  • Use a TL;DR or an executive summary.
  • Clearly and concisely define/outline the most important idea(s).

8. Headings

  • Assume your reader relies on headings to keep track of context in your post.
    • "What is this section about?"
  • Use headings to segment your post into clearly identifiable sections.

9. Conclusions

  • Assume your reader does not know what you're concluding in your post.
    • "So what?"
  • Provide a clear, concise conclusion.

10. Relationships

  • Assume your reader does not understand how the concepts are related in your post.
    • "What does that have to do with this?"
  • Clearly define all of the factors/variables and concepts/ideas you will connect.
  • Connect the dots and outline relationships between ideas.
  • Walk readers through your reasoning when relating ideas.

11. Logic

  • Assume your reader does not understand the logic behind the conclusion(s) in your post.
    • "How can I conclude that?"
  • Clearly define all of the premises and steps necessary to form your conclusion(s).
  • Spell out the logic when making a conclusion.

12. Inferences

  • Assume your reader has not made any of the observations you have that you use to make inference(s) in your post.
    • "How do I infer this?"
  • Clearly establish the context by defining your observations and how you believe they are related/relevant.
  • Supply the concrete details.

13. Pragmatic

  • Assume your reader does not know why your post matters.
    • "So what?"
  • Be pragmatic and provide practical applications that explain why your post is important and relevant to life/reality.

14. Transitions

  • Assume your reader needs clear transitions to follow your flow/train of thought in your post.
    • "How do these things relate?"
  • Use clear transitions to cue the reader and connect previous ideas to the next ideas.

15. Connection

  • Assume your reader wants to feel a human connection to you and your post.
    • "Do I feel like I connect with this?"
  • Be real, conversational, and convivial (simpatico).

16. Impressions

  • Assume your reader is making a first impression of you that will determine whether or not they will ever engage with you or your posts.
    • "Is this a good first impression?"
  • Be warm, friendly, and pleasant.

17. Relatability

  • Assume your reader won't understand or remember your idea(s) if they cannot connect and relate to your post.
    • "Does this have any relation or relevance to me?"
  • Use familiar, congenial, and understandable language.

18. Sensitivity

  • Assume your reader may be sensitive to the topic(s) in your post.
    • "Is this insensitive?"
  • Replace judgmental, condescending, or overly critical language with kind, considerate, and respectful language.

19. Interest

  • Assume your reader may get bored or disinterested with your post.
    • "Is this interesting?"
  • Replace dry, dull, and monotonous language with fun, stimulating, and compelling language.

20. Conversational

  • Assume your reader wants a quick, conversational summary in your post.
    • "Whatchya writing about?"
  • Final revising technique: Quickly paraphrase/read your writing out loud to a friend in about 2 minutes, skimming and summarizing it from beginning to end.
    • How do you word things quickly and conversationally?
    • What main points did you cover? Did you phrase them better when speaking?
    • What points did you skip? Could they be removed?
    • What questions did your friend ask you? Do you answer those in your writing?
    • How did you feel saying everything out loud?
    • How did your friend feel while listening?
    • Did your friend understand your ideas?

21. Representation

An additional tip for the forum:

  • Assume your reader believes that you represent the EA community in your post.
    • "What's this EA community like?"
  • Be welcoming, inclusive, and considerate.

Best Advice

"Whoa, 22 tips! That's too many; just gimme the good stuff."

Ok, fine; 22 is a big number. Here's the best advice I can offer in 3 steps:

  1. While you're writing, think of 3-5 diverse people as your audience (e.g. someone old, someone young, someone from another country, someone from a different socioeconomic background, someone from a different culture, etc). Make sure they are real people that you know well enough to imagine their responses. Picture them reading and reacting to your post, sentence by sentence. What do they say? (Revise as you go.)
  2. Once you've finished your first draft, imagine watching 2 of your favorite authors read your post. How would they react? If you asked for them for feedback, how would they reply? (Go back and rewrite again.)
  3. Finally, once you've gone through a few drafts and feel like you've got it, ask at least 2 diverse people to read it and give you feedback. (Make your final revisions.)

Principles

Underlying each of these tips are fundamental ideals on what "good" writing is, based on core concepts of readability and approachability.

Readable writing is:

  • Clear (Clarity)
    • Comprehensible
    • Understandable
    • Transparent
    • Simple
    • Straightforward
  • Brief (Brevity)
    • Concise
    • Precise
    • Minimal
    • Succinct
    • Synoptic

Approachable writing is:

  • Welcoming
    • Inclusive
    • Familiar
    • Congenial
    • Convivial
    • Pleasant
  • Loving
    • Kind
    • Friendly
    • Caring
    • Considerate
    • Understanding

References

I'm not the first person to write about readability (on a forum or otherwise), so I want to call out great resources on this topic.

First, a video:

EA Forum posts

On summaries

On jargon

On brevity

On interest and impact

On norms

Topics

Conclusion

"It's all about empathy, baby!" — the less "proverbial" young person[1]

It sounds oxymoronic and paradoxical at first, but making assumptions about your reader can actually help your writing become more understandable to a broader audience.
The key is in which assumptions you make!

It really comes down to:

  1. Don't assume your reader is you!
  2. Instead, assume your reader is someone else who would happily understand you if you write for them.

I believe that "writing for the reader" is the most caring thing an author can do.


  1. P.S. From the author: I'm still learning all of this now, so my writings from before (October 2022) are not good examples of readable posts. I don't always exemplify this skill yet, so please don't call me a hypocrite until at least a few posts/months later 😅 ↩︎

Comments6


Sorted by Click to highlight new comments since:

This post is "Step 1" towards a side mission: "to make the EA Forum more readable and approachable."

Improving written language for readers is a great way to practice making the EA Forum/community more:

  • friendly
  • welcoming
  • inclusive
  • congenial
  • compelling
  • considerate
  • thoughtful
  • caring
  • kind
  • understandable
  • understanding
  • (and also, yeah, altruistic)

From the outside looking in:

"A readable and approachable writing/forum" = "A reasonable and approachable people/community"

  • By making writings more readable, you demonstrate your understanding of others.
  • By making writings more approachable, you demonstrate your care for others.

I guess "Step 2" became my next post: Toward a more approachable and accessible EA Forum

(But it reads as a preface/prelude to this post, so it's more like how the Star Wars trilogies were released out of order...... haha, far stretch of an example)

This post seems specifically to be readability tips for a sort of 101, general audience when neither reader nor writer has a clear role or project motivating the article.

And I’d argue that this “general audience” target actually is the hardest to write for, even though it’s the easiest to put writing in front of. By contrast it is easy to dash off an email that will be read with high likelihood by 1 specific person if you’re involved in a project together.

I think it would be helpful if we formed “focus groups” on the forum - small groups of writer-readers with a common interest. They write for each other; then post the best output on the forum.

I should also probably clarify again that my motives are to see the EA Forum and its ideas be spread to a broader audience. I want it to grow and become more welcoming and inclusive.

In fact, I just decided to write an entire post about just that: Toward a more approachable and accessible EA Forum

I've gotta hand it to ya @AllAmericanBreakfast: your comment inspired me to write more about how this is all connected to EA communication, connection, and community building. Cheers!

Oh, fascinating! I've never come across an idea like these "focus groups" on a forum. Have you tried this before?

(I suppose, upon reflection, I might regard the things I've created for a small audience of friends to account for maybe a third of my best work...? haha very rough estimates of course.)

I’m actually working on a fleshed out version for EA forum, I can share the draft if you like.

Curated and popular this week
 ·  · 22m read
 · 
The cause prioritization landscape in EA is changing. Prominent groups have shut down, others have been founded, and everyone’s trying to figure out how to prepare for AI. This is the third in a series of posts critically examining the state of cause prioritization and strategies for moving forward. Executive Summary * An increasingly common argument is that we should prioritize work in AI over work in other cause areas (e.g. farmed animal welfare, reducing nuclear risks) because the impending AI revolution undermines the value of working in those other areas. * We consider three versions of the argument: * Aligned superintelligent AI will solve many of the problems that we currently face in other cause areas. * Misaligned AI will be so disastrous that none of the existing problems will matter because we’ll all be dead or worse. * AI will be so disruptive that our current theories of change will all be obsolete, so the best thing to do is wait, build resources, and reformulate plans until after the AI revolution. * We identify some key cruxes of these arguments, and present reasons to be skeptical of them. A more direct case needs to be made for these cruxes before we rely on them in making important cause prioritization decisions. * Even on short timelines, the AI transition may be a protracted and patchy process, leaving many opportunities to act on longer timelines. * Work in other cause areas will often make essential contributions to the AI transition going well. * Projects that require cultural, social, and legal changes for success, and projects where opposing sides will both benefit from AI, will be more resistant to being solved by AI. * Many of the reasons why AI might undermine projects in other cause areas (e.g. its unpredictable and destabilizing effects) would seem to undermine lots of work on AI as well. * While an impending AI revolution should affect how we approach and prioritize non-AI (and AI) projects, doing this wisel
 ·  · 4m read
 · 
TLDR When we look across all jobs globally, many of us in the EA community occupy positions that would rank in the 99.9th percentile or higher by our own preferences within jobs that we could plausibly get.[1] Whether you work at an EA-aligned organization, hold a high-impact role elsewhere, or have a well-compensated position which allows you to make significant high effectiveness donations, your job situation is likely extraordinarily fortunate and high impact by global standards. This career conversations week, it's worth reflecting on this and considering how we can make the most of these opportunities. Intro I think job choice is one of the great advantages of development. Before the industrial revolution, nearly everyone had to be a hunter-gatherer or a farmer, and they typically didn’t get a choice between those. Now there is typically some choice in low income countries, and typically a lot of choice in high income countries. This already suggests that having a job in your preferred field puts you in a high percentile of job choice. But for many in the EA community, the situation is even more fortunate. The Mathematics of Job Preference If you work at an EA-aligned organization and that is your top preference, you occupy an extraordinarily rare position. There are perhaps a few thousand such positions globally, out of the world's several billion jobs. Simple division suggests this puts you in roughly the 99.9999th percentile of job preference. Even if you don't work directly for an EA organization but have secured: * A job allowing significant donations * A position with direct positive impact aligned with your values * Work that combines your skills, interests, and preferred location You likely still occupy a position in the 99.9th percentile or higher of global job preference matching. Even without the impact perspective, if you are working in your preferred field and preferred country, that may put you in the 99.9th percentile of job preference
 ·  · 5m read
 · 
Summary Following our co-founder Joey's recent transition announcement we're actively searching for exceptional leadership to join our C-level team and guide AIM into its next phase. * Find the full job description here * To apply, please visit the following link * Recommend someone you think could be a great fit here * Location: London strongly preferred. Remote candidates willing to work from London at least 3 months a year and otherwise overlapping at least 6 hours with 9 am to 5 pm BST will be considered. We are happy to sponsor UK work visas. * Employment Type: Full-time (35 hours) * Application Deadline: rolling until August 10, 2025 * Start Date: as soon as possible (with some flexibility for the right candidate) * Compensation: £45,000–£90,000 (for details on our compensation policy see full job description) Leadership Transition On March 15th, Joey announced he's stepping away from his role as CEO of AIM, with his planned last day as December 1st. This follows our other co-founder Karolina's completed transition in 2024. Like Karolina, Joey will transition to a board member role while we bring in new leadership to guide AIM's next phase of growth. The Opportunity AIM is at a unique inflection point. We're seeking an exceptional leader to join Samantha and Devon on our C-level team and help shape the next era of one of the most impactful organizations in the EA ecosystem. With foundations established (including a strong leadership team and funding runway), we're ready to scale our influence dramatically and see many exciting pathways to do so. While the current leadership team has a default 2026 strategic plan, we are open to a new CEO proposing radical departures. This might include: * Proposing alternative ways to integrate or spin off existing or new programs * Deciding to spend more resources trialling more experimental programs, or double down on Charity Entrepreneurship * Expanding geographically or deepening impact in existing region