Live data from Hacker News

How to Write in Plain English

plainenglish.co.uk

81–90 of 327 posts

Re: How to Write in Plain English

#81
post #56

English vs. business English. Pre-boarding is just boarding. Pre-booking is just booking. Pre-prefixing everything. Sigh. "Please revert" - you mean 'reply', not 'return to a former state'. "Ping me" - ugh. And my favourite.... "Learnings" - you mean lessons. "What drivings have you been on?" ... "What journeys have you been on?"

"Sense check" is one that infuriates me. Just say "check".

Every place I've worked with managers that speak like this has invariably produced crap.

Re: How to Write in Plain English

#82
post #56

English vs. business English. Pre-boarding is just boarding. Pre-booking is just booking. Pre-prefixing everything. Sigh. "Please revert" - you mean 'reply', not 'return to a former state'. "Ping me" - ugh. And my favourite.... "Learnings" - you mean lessons. "What drivings have you been on?" ... "What journeys have you been on?"

Dunno, Ping me felt quite natural to me. It feels like a handy substitute for when there are multiple options for one person to contact another and person one does not care how he is contacted. As opposed to very formal communications that stick to email or mail.

Ping me => email/call/slack/whatsapp/zulip/telegram/meet-in-person me

Re: How to Write in Plain English

#83
post #56

English vs. business English. Pre-boarding is just boarding. Pre-booking is just booking. Pre-prefixing everything. Sigh. "Please revert" - you mean 'reply', not 'return to a former state'. "Ping me" - ugh. And my favourite.... "Learnings" - you mean lessons. "What drivings have you been on?" ... "What journeys have you been on?"

The definition of "revert" has evolved, and even dictionaries are starting to acknowledge its alternative meaning as "reply". See: https://www.nytimes.com/2010/06/06/magazine/06FOB-onlanguage...

I personally love "ping me". It's even shorter and more punchy, compared to "message me".

Language evolves. Shakespeare would find our English today bewildering. Instead of complaining about it, I find it most helpful to keep up with the latest lingo, and focus instead on conveying my message most clearly.

Re: How to Write in Plain English

#84

I'm curious. Is there a specific reason why the trend for our use of the English language went towards this direction, when in the past, a lot of the historical material I read seemed intentionally verbose? Sure, it's all for ensuring we are understood better among ourselves, but I wonder if writing this way makes us cognitively simpler.

It is not so much about verbosity as it is about clarity in public communication. It is not about preventing a poetic turn of phrase but about avoiding the all too common business bullshit intended to deflect blame and shift responsibility by muddling the content to near incomprehensibility.

Re: How to Write in Plain English

#85
post #38

Writing clearly is like playing Tetris. Sentences should be presented with clauses that drop down and slot together efficiently. At the earliest available opportunity you drop in a block that completes the line and points are won/made. This can also make for rather dull writing and I appreciate the irony in this paragraph: > However, at first you may still find yourself writing the odd long sentence, especially when…

Don't make your readers hold parts of the sentence in their head. Reorder or split sentences until it can be avoided. In other words, use a really small buffer. "You must fill form 331 unless you are over 60 years old, in which case you must fill form 445." "You must fill form 331. If you are over 60 years old, you must fill 445 instead." "If you are over 60 years old, you must fill form 445. Otherwise, you must fill…

> Don't make your readers hold parts of the sentence in their head.

Funny to read this as I'm learning German! In German the main verb of a sentence has to be at the end depending on the context (e.g: if it is a question, or following some prepositions such as "dass").

Let's say we want to build a question, it will be constructed this way:

1. question marker (such as "Was", "Wo", "Warum", etc)

2. subject

3. other details regarding the subject (adjectives and others)

4. the verb, with correct grammatical form depending on the subject

Something I find quite frustrating is that I have to keep in mind everything about the subject during the entire duration of the sentence just to be able to use the verb correctly. So because of this I always try to keep the distance between a subject and the verb as short as possible when trying to speak German, which results in very terse sentences that looks similar to what you described.

My life partner speaks native German and doesn't even realize that she does this buffering.

Re: How to Write in Plain English

#86
When the purpose of written communication is to direct, instruct or inform, Plain English works wonders.

Other times, like when people write to demonstrate nuanced expertise, or to connect with a specific audience, or to place themselves apart from a specific audience, or to entertain, delight, uplift, transcend, prod, annoy, or console, Plain English can be too plain.

Re: How to Write in Plain English

#87
post #14

Heres a great list from GOV.UK of the kind of words to avoid when using Plain English: https://www.gov.uk/guidance/style-guide/a-to-z-of-gov-uk-sty...

I like how they banned "empower" with no added explanation while the Rust team was bending backwards to argue that there is nothing wrong with the word when, in 2018, they controversially changed their motto to "A language empowering everyone to build reliable and efficient software." (https://rust-lang.org/)

Obviously gov.uk material is of a different nature than that of a corporate motto, but it speaks to the exasperate community complaints at that time.

Re: How to Write in Plain English

#89
post #57

Earlier quoted context omitted.

Your last one requires keeping the first clause of the first sentence in your head; just because you've split sentences doesn't mean you've avoided that, because “otherwise” imports the conditional in the previous sentence by reference and then inverts it. To actually avoid requiring the reader to keep sentence parts in their head, use if-then or do-if constructs, but not if-then-else constructs. “Complete form 445 i…

That's a bad example of how to express age limits. If I've just had my 60th birthday, or perhaps today is my birthday, which applies, or do I have to fill in both forms? Also, is it my age at the time I sign the form, or my age at the time the form is received, that matters? Arguably that's a problem with the rule itself rather than how it's expressed. It's better if you can write something like: "If you were born be…

Oh man I'm having day nightmare flashbacks about the time I spent days parsing some well-meant European Energy-Saving directive and figuring out whether we could sell a PC with a fixed-frequency CPU, and all power- and energy-saving features disabled (latency concerns). Ouch... There were some official and unofficial logic diagrams and they made things even worse. Lexicon was pretty vague, use-cases too, exceptions too... and you end up writing some kind of justification for you being one of the special cases and praying it's OK. And it wasn't even the worst normative document I've ever read. It was clear about the spirit of the directive...

Imprecise language to allow flexibility and 'let the judges decide'... I'm not sure I'm comfortable with common-law-inspired regulation.

Not sure how to do this better though.

Re: How to Write in Plain English

#90
post #59
post #56

English vs. business English. Pre-boarding is just boarding. Pre-booking is just booking. Pre-prefixing everything. Sigh. "Please revert" - you mean 'reply', not 'return to a former state'. "Ping me" - ugh. And my favourite.... "Learnings" - you mean lessons. "What drivings have you been on?" ... "What journeys have you been on?"

“Ping me” really threw me for a loop the first time I heard a non-tech say it in an obvious non-tech way. It literally has no other meaning outside of the ICMP echo utility; and the onomatopoeia of hitting glass. How did it enter the Business world?

[deleted]
Post reply on HN