← Back to context

Comment by kqr

2 days ago

Oh, this one is difficult. I vacillated a lot in my early writing between I, we, and you.

Too many "I" sounds self-fixated and irrelevant for the reader. "You" is way too presumptive, unless addressing a specific person or specific group with actual evidence. "We" can also read as too presumptive, but I feel like it works in the case of processes the reader could volunteer to be part of. However, it must not be used to project emotions or experiences onto the reader.

For now, I've personally settled on "we" for most things (because the reader could hypothetically choose to follow along actively), but switching into "I" if I need to discuss something negative or a failing of my own. In other words, I would never project "a constant state of grief" on my readers – that I can only attribute to myself.

When I refer to something that cannot be experienced by myself, only by my readership (e.g. because it happens only to people who do not know where the article is going), I prefer "the reader" over "you", because while it might be true for the median reader, it might not be true for each and every individual reading.

I'm glad someone else also cares about this! I don't find it discussed very much.

-----

Here's a decent example of what I mean: https://entropicthoughts.com/packaging-perl-and-shell-for-ni...

(1) It starts out with "I" having trouble packaging – my readers are generally more intelligent and experienced than I am, so I won't assume they have the same trouble.

(2) Then we go into my experience, but phrased in a way where the reader could hypothetically follow along. Thus, I ask the reader to imagine "we" have a Perl script.

(3) Somewhere in the middle, the article refers to something that might be noticed by "the very attentive reader". I do not expect everyone to, not even the median reader, but I realise some readers might.

(4) The appendix contains a note in case "you" are very curious, because here I do address each and every reader individually.

Technical writing should be third person passive, so forget all those pesky pronouns.

  • That is commonly claimed, but it is thought by some to lead to unnecessarily complicated text. A tendency is also noticed for the passive voice to be introduced as part of such rules.

    In case the irony isn't clear, I disagree. Clarity first, and stylistic choices after that.