Live data from Hacker News

How to Write in Plain English

plainenglish.co.uk

101–110 of 327 posts

Re: How to Write in Plain English

#101
post #38

Earlier quoted context omitted.

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…

Experienced UX practitioners will immediately note that a surprisingly large proportion of users don't actually know how old they are; furthermore, of those that do, another significant segment will (intentionally or otherwise) mis-state their age, date of birth etc. This problem is further exacerbated by the wide variety of temporal arithmetic possibilities any such workflow might adopt. The solution is to either co…

> a surprisingly large proportion of users don't actually know how old they are

How did they manage this? I've tried every way I can think of forgetting my age, to no avail -the bastard number is always there :)

Re: How to Write in Plain English

#102
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?"

You might like this George Carlin stand-up show: https://youtu.be/6IC_It9DwDA?t=82

Re: How to Write in Plain English

#103
post #85
post #38

Earlier quoted context omitted.

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 det…

I was just thinking about German the whole time.

I knew a German to Polish translator and she complained about how hard live translation was when a key part of the sentence is held until the very end.

Re: How to Write in Plain English

#104

This Orwell essay stuck with me many years ago, well worth a read: https://www.orwell.ru/library/essays/politics/english/e_poli...

It's only the best English essay of its kind — or maybe of any kind!

It could well be!

Reading it properly again for the first time in literally around 30 years I'm astonished at how much I've taken its messages to heart in my 20+ year career.

To this day I have a downright visceral reaction against "pretentious diction", and as a fairly confident written communicator I find overly "clever" writing is to be mistrusted, not praised. There's a real Emperor's New Clothes thing going on with a lot of business writing.

Re: How to Write in Plain English

#105
post #53
post #51

Earlier quoted context omitted.

This is how I felt while reading philosophy essays. I'm not even sure half of those are even saying anything.

A lot of philosophy essays are written as part of the writer being in the process of trying to figure things out for themselves, without quite having gotten there yet.

This is why second drafts exist

Re: How to Write in Plain English

#106
post #101

Earlier quoted context omitted.

Experienced UX practitioners will immediately note that a surprisingly large proportion of users don't actually know how old they are; furthermore, of those that do, another significant segment will (intentionally or otherwise) mis-state their age, date of birth etc. This problem is further exacerbated by the wide variety of temporal arithmetic possibilities any such workflow might adopt. The solution is to either co…

> a surprisingly large proportion of users don't actually know how old they are How did they manage this? I've tried every way I can think of forgetting my age, to no avail -the bastard number is always there :)

I'm in my late twenties and sometimes I need to pause, a bit like dealing with left/right or east/west.

Re: How to Write in Plain English

#107
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…

[deleted]

Re: How to Write in Plain English

#108
post #79
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?"

I thought that "pre-booking" means that you input all the available data related to a document into some computer system, but you do not finalize & accept the document yet -> so some of the data can still be changed in the future without consequence (for example: when some issue is explained with a supplier). Pre-booking is the initial step before a complete booking.

Agreed. Except when it isn't :)

Ticket agencies use 'pre-booking' to book the first tiny tranche of tickets.

And HR departments seem to love 'pre-authorization' to get... authorization for holidays, or purchasing, and so on.

Re: How to Write in Plain English

#109
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?"

You might like this George Carlin stand-up show: https://youtu.be/6IC_It9DwDA?t=82

Nice. Surprised I hadn't seen that.

Re: How to Write in Plain English

#110
post #38

Earlier quoted context omitted.

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…

Or just have a proper online form that asks for your DoB and leads you through entry of the necessary info. FWIW in UK 'must' in gov advice indicates a legal obligation. It annoys me no end when such obligations are not supported by references to legislation: as then I can't check if they've been correctly interpreted. Prose should be readable, but also functional.

That works for forms. I write static content.

I did start adding little calculators and utilities in my articles, but those only make sense because I have a lot of free time.

I heavily cite sources, so at least you'd know the exact paragraph in the law that supports it. It's something my competitors neglect, and it makes it hard to tell facts apart from hearsay.

Post reply on HN