TE
科技回声
首页24小时热榜最新最佳问答展示工作
GitHubTwitter
首页

科技回声

基于 Next.js 构建的科技新闻平台,提供全球科技新闻和讨论内容。

GitHubTwitter

首页

首页最新最佳问答展示工作

资源链接

HackerNews API原版 HackerNewsNext.js

© 2025 科技回声. 版权所有。

How to Write in Plain English

724 点作者 zackhsi将近 5 年前

61 条评论

gorgoiler将近 5 年前
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&#x2F;made.<p>This can also make for rather dull writing and I appreciate the irony in this paragraph:<p><i>&gt; However, at first you may still find yourself writing the odd long sentence, especially when trying to explain a complicated point. But most long sentences can be broken up in some way.</i><p>Here we see the Tetris player drop a sequence of blocks leaving a 3x1 gap down the left edge. Where are they going with this? More blocks stack up on the middle and right, there are “bubbles” in the pile that are covered by squares and there’s still that annoying gap on the left holding them back from clearing. Time passes. The screen is now getting dangerously full.<p>Then they drop in a pair of 4x1 blocks that completes rows 1, 2, 3, 5 and 6. The bubbles on rows 4 and 7 become exposed making a T shaped hole. The next block to fall is a T shape. The screen clears, the sentence’s cognitive buffer is flushed, and we move on to the next point.
评论 #24269501 未加载
评论 #24269034 未加载
评论 #24269517 未加载
评论 #24268994 未加载
评论 #24270567 未加载
评论 #24268958 未加载
评论 #24269771 未加载
aazaa将近 5 年前
The article doesn&#x27;t mention the way that word placement changes the meaning of sentences. From a video I recently saw but can&#x27;t recall, consider these sentences:<p>- Although John is a nice guy, he beats his dog.<p>- Although John beats his dog, he&#x27;s a nice guy.<p>- John is a nice guy, but he beats his dog.<p>- John beats his dog, but he&#x27;s a nice guy.<p>These are all plain English sentences, but will be interpreted quite differently. For the moment, try to set aside the moral judgement on dog beating and consider what the author&#x27;s opinion of John is in each case.<p>For example, readers tend to latch onto the last part of a sentence. So putting the nice guy part last tends to support John. Whereas putting the dog beating last tends to undermine John.<p>Same facts, almost the same words, but different messages.
评论 #24271089 未加载
评论 #24271093 未加载
评论 #24270962 未加载
评论 #24270879 未加载
评论 #24272478 未加载
dreen将近 5 年前
Heres a great list from GOV.UK of the kind of words to avoid when using Plain English:<p><a href="https:&#x2F;&#x2F;www.gov.uk&#x2F;guidance&#x2F;style-guide&#x2F;a-to-z-of-gov-uk-style#words-to-avoid" rel="nofollow">https:&#x2F;&#x2F;www.gov.uk&#x2F;guidance&#x2F;style-guide&#x2F;a-to-z-of-gov-uk-sty...</a>
评论 #24269271 未加载
评论 #24269272 未加载
评论 #24269980 未加载
评论 #24269374 未加载
评论 #24269369 未加载
评论 #24271205 未加载
评论 #24269492 未加载
评论 #24272781 未加载
aclimatt将近 5 年前
I&#x27;d guess (almost) everyone wishes everyone else wrote in plain language. But there&#x27;s potentially a more fundamental reason people don&#x27;t. bambax in another comment pointed out the power of ambiguity, and that&#x27;s one of the reasons especially in legal &#x2F; government, but there&#x27;s another.<p>Language, specifically jargon, is an expression of culture. It&#x27;s an expression of power, education, experience, or lack thereof. It&#x27;s a quick way to gauge if someone is &quot;like you&quot; or not. If they have the same experience, and especially in professional settings, a quick (yet often incorrect) measure of competence.<p>Take everyone&#x27;s favorite, &quot;Business English&quot;:<p>You don&#x27;t try again, you <i>iterate</i>. You don&#x27;t take another call, you <i>jump</i> or <i>hop</i> to another call. You <i>sync</i>, and you <i>align</i>. Against the article&#x27;s recommendation, you nominalize all day, by &quot;bringing projects to completion&quot; and &quot;moving forward with the engagement&quot;.<p>Jargon and style, while often utter bullshit, is a way of measuring people quickly. I once had someone ask me, &quot;would you say you practice disruptive innovation methodology?&quot; My answer to that question was a quick way to learn that unlike them, I did not have an MBA. Complexity is often synonymous with education.<p>&gt; Jargon is a type of language that is only understood by a particular group of people. You can use jargon when writing to people who will understand the terms and phrases. It can be a useful form of shorthand. But try to avoid using specialist jargon on the general public.<p>Unless your goal is to identify if someone is part of said particular group. And therefore in the vast majority of business and technical cases, Plain English -- at least jargon and nominalization -- unfortunately may close more doors than it opens.
评论 #24270430 未加载
评论 #24270420 未加载
评论 #24270681 未加载
icu将近 5 年前
Plain English has been a &#x27;super power&#x27; for my report writing ever since it was drummed into me by a former CEO and MD at a finance and economic consultancy I worked at after University.<p>&quot;Style toward Clarity and Grace&quot; by Joseph M. Williams is, imho, the most thorough, yet comprehensible, guide to how to write in Plain English. It goes beyond short &#x27;do this, don&#x27;t do that&#x27; guides by explaining why, and how, English can be unclear with exercises to help transform your writing.<p>I can&#x27;t stress enough that the ability to take both simple ideas, and complex ideas, and write both in a clear and compelling way that inspires action, will pay dividends over any career.
评论 #24269797 未加载
ajarmst将近 5 年前
This is good advice, but we should be wary of assuming that writing well is easy or a matter of following rules. Like most things worth doing, good writing requires that we practice it regularly and over a period of years, that we are exposed to good writing, and that we have access to competent feedback on our own writing.<p>Every decent writer I know has worked diligently at practice, usually for years. They&#x27;re also omnivorous readers of good long-form writing. Finally, they seek and are grateful for the advice of a good editor.<p>Talent can help you advance in skill more quickly and perhaps reach a higher ultimate plateau, but it does little to replace the requirement for observation, practice and review. I&#x27;ve often thought that talent is indistinguishable from interest and passion---it&#x27;s what gets you to do the work, not a replacement for it.<p>Some minor comments: &quot;utilize&quot; should be on the list of words to avoid. I have yet to encounter a use of that word that wouldn&#x27;t be improved by replacing it with &quot;use&quot;. In technical and scientific writing, passive voice can be valuable when the salient concern is not the actor, but the act and its consequences. &quot;The sheep were administered methamphetamine one hour before being tased&quot; focuses on the study, while &quot;we gave the sheep meth and then we tased them&quot; focusses on the scientists. The former is often better for this type of writing.<p>Note: the example is from one of my favourite studies. I wish I had heard about before I chose my thesis topic: <a href="https:&#x2F;&#x2F;onlinelibrary.wiley.com&#x2F;doi&#x2F;full&#x2F;10.1111&#x2F;j.1553-2712.2010.00708.x" rel="nofollow">https:&#x2F;&#x2F;onlinelibrary.wiley.com&#x2F;doi&#x2F;full&#x2F;10.1111&#x2F;j.1553-2712...</a>
srg0将近 5 年前
How to write rich text English:<p>1) The writer should make a conscious effort to keep his or her sentences as long as possible; just one word: the flow; some shorter sentences can be juxtaposed, periods replaced with comas or semicolons; the abundance of adjectives and adjective phrases never hurt --<p>2) The passive voice has to be chosen whenever possible; safer, less offensive, less responsible language is the enabler<p>3) Possessive determiners are to be preferred over personal pronouns, the passive voice is based on their liberal use<p>4) Thesaurus is considered by some to be essential for richer and more subtle communication, word substitutions refine the ideas being conveyed to the reader --<p>-- the reader should be never explicitly solicited to do anything -- he or she should be free-willed into doing<p>6) Consideration of these dos and donts will likely unleash also the power of nominalization; nominalized verbs put action first<p>*) Bullet lists are the standard punctuation;<p>&#x2F;s
bertman将近 5 年前
The campaign founder&#x27;s biography[1] sounds interesting:<p><pre><code> Born in 1938, Chrissie largely missed out on formal education and could not read until she was in her mid‑teens. </code></pre> And later:<p><pre><code> In 1994 Chrissie received an OBE and in 1995 she was awarded an honorary MA by Manchester University. Two years later, she received an honorary doctorate from the Open University. And in 1999 she officially joined the &#x27;establishment&#x27; when she was listed in Who&#x27;s Who. </code></pre> [1] <a href="http:&#x2F;&#x2F;www.plainenglish.co.uk&#x2F;about-us&#x2F;history&#x2F;chrissie-maher-obe.html" rel="nofollow">http:&#x2F;&#x2F;www.plainenglish.co.uk&#x2F;about-us&#x2F;history&#x2F;chrissie-mahe...</a>
Brajeshwar将近 5 年前
Personally, I&#x27;m happy with few tools that helps me write simpler (and hopefully better) English in my everyday usage.<p>## Long-Form<p>When I&#x27;m writing a long-form prose&#x2F;essay, I start writing in Hemingway[1]. Edits and changes are done there to cater to my target audience. I&#x27;d then pick up the draft from there and go through Grammarly[2] as the final passage.<p>## Quick, Short Writings<p>For everyday use, I use iA &#x2F; Writer[3]. I turn on all the Style Check filters to spot superfluous adjectives, weak verbs, and unwanted repetitions. I then, let it go through Grammarly (either with the App, or via browser Input fields).<p>This has helped me a lot. Growing up in a region with too many dialects per area, we used English as the one medium to communicate and educate, so I have the affinity to write more phrase-y, English-y. For quite a while, I have wanted to simply and write more clearer, simpler, and effective. These three tools have helped me a lot.<p>I have used Grammarly for almost a year, it says my vocabulary uses more unique words than 94% of Grammarly users. I&#x27;m not particularly proud of that. I want to simplify.<p>1. <a href="http:&#x2F;&#x2F;www.hemingwayapp.com" rel="nofollow">http:&#x2F;&#x2F;www.hemingwayapp.com</a><p>2. <a href="https:&#x2F;&#x2F;grammarly.com" rel="nofollow">https:&#x2F;&#x2F;grammarly.com</a><p>3. <a href="https:&#x2F;&#x2F;ia.net&#x2F;writer" rel="nofollow">https:&#x2F;&#x2F;ia.net&#x2F;writer</a>
DrBazza将近 5 年前
English vs. business English.<p>Pre-boarding is just boarding. Pre-booking is just booking.<p>Pre-prefixing everything. Sigh.<p>&quot;Please revert&quot; - you mean &#x27;reply&#x27;, not &#x27;return to a former state&#x27;.<p>&quot;Ping me&quot; - ugh.<p>And my favourite.... &quot;Learnings&quot; - you mean lessons. &quot;What drivings have you been on?&quot; ... &quot;What journeys have you been on?&quot;
评论 #24271049 未加载
评论 #24269943 未加载
评论 #24270557 未加载
评论 #24271224 未加载
评论 #24269746 未加载
评论 #24270206 未加载
评论 #24269926 未加载
评论 #24269901 未加载
评论 #24270020 未加载
评论 #24269948 未加载
robin_reala将近 5 年前
This article explains how, but it doesn’t explain why: you should do this because it’s an accessibility issue. NHS Digital came up with a good example of this problem: <a href="https:&#x2F;&#x2F;digital.nhs.uk&#x2F;blog&#x2F;transformation-blog&#x2F;2019&#x2F;pee-and-poo-and-the-language-of-health" rel="nofollow">https:&#x2F;&#x2F;digital.nhs.uk&#x2F;blog&#x2F;transformation-blog&#x2F;2019&#x2F;pee-and...</a>
评论 #24269120 未加载
评论 #24269311 未加载
评论 #24270110 未加载
bambax将近 5 年前
I frequently receive letters from various European administrations, France, Germany, Poland, the UK.<p>Letters from HMRC are amazing. The first time it is really shocking, but after a while it&#x27;s almost a pleasure to be asked to send money to the Queen!<p>But I think one of the reason bureaucracies prefer writing jargon and long winded sentences is to protect their influence and necessity. If you write in plain English (or French), then there&#x27;s little room for interpretation. Good for the reader, but not for the sender. Ambiguity is power.
评论 #24270959 未加载
williamsmj将近 5 年前
The Plain English Campaign is not a useful authority on English usage. They are a group of prigs and pedants who issue press releases about alleged errors by famous people in the hope they will receive coverage in the British press and bring in work for their consulting business.<p>I&#x27;m distressed to learn they now expound at book length and I&#x27;m surprised to see this garbage taken seriously by HN.<p>See, e.g. <a href="http:&#x2F;&#x2F;itre.cis.upenn.edu&#x2F;~myl&#x2F;languagelog&#x2F;archives&#x2F;002229.html" rel="nofollow">http:&#x2F;&#x2F;itre.cis.upenn.edu&#x2F;~myl&#x2F;languagelog&#x2F;archives&#x2F;002229.h...</a>, <a href="https:&#x2F;&#x2F;web.archive.org&#x2F;web&#x2F;20110510090548&#x2F;http:&#x2F;&#x2F;oliverkamm.typepad.com&#x2F;blog&#x2F;2004&#x2F;03&#x2F;plain_english_b.html" rel="nofollow">https:&#x2F;&#x2F;web.archive.org&#x2F;web&#x2F;20110510090548&#x2F;http:&#x2F;&#x2F;oliverkamm...</a>.
评论 #24275219 未加载
jhpriestley将近 5 年前
It is not only the sheer pleasure of reading language used to its utmost, an indulgence found in the enduring literary accomplishments of Shakespeare or Dickens but somewhat lacking in the trendier, reportorial style of a Hemingway (who, after a hundred years, it seems safe to say has not reached the same level of immortal acclaim), but also if I may venture, a particular suitability to the kind of digressive, meandering, rich and nuanced thought, a precious and valuable part of human intellect, a rich roast which loses much of its savor when cut into bite-sized chunks, which recommends, contra all the style advice of today&#x27;s factory-line English departments, an appreciation and a space for the continuation of the English of Milton and Gibbons and Melville as against the simplified, utilitarian style recommended in the fine article.
评论 #24274087 未加载
评论 #24275138 未加载
评论 #24273809 未加载
lxe将近 5 年前
Don&#x27;t follow the &#x27;active verbs&#x27; rule too much. There&#x27;s a limit to it, especially when writing technical documents. If it sounds unnatural, or when you have an implied subject that&#x27;s an important part of the thing you&#x27;re trying to convey, just use passive voice.
评论 #24269203 未加载
评论 #24269296 未加载
评论 #24271094 未加载
fooblat将近 5 年前
This is especially important when working at an international company with many non-native English speakers.<p>One of the software engineers (an English major) I worked with at a previous gig could not get his head around the idea of writing in plan English.<p>He would write English at such an elaborate level that when he announced his resignation to the company via email, most people did not understand from that email that he was resigning!
macando将近 5 年前
From Stephen King&#x27;s <i>On Writing: A Memoir of the Craft</i>:<p>&quot;If you want to be a writer, you must do two things above all others: read a lot and write a lot. There’s no way around these two things that I’m aware of, no shortcut.<p>I’m a slow reader, but I usually get through seventy or eighty books a year, mostly fiction. I don’t read in order to study the craft; I read because I like to read. It’s what I do at night, kicked back in my blue chair. Similarly, I don’t read fiction to study the art of fiction, but simply because I like stories. Yet there is a learning process going on. Every book you pick up has its own lesson or lessons, <i>and quite often the bad books have more to teach than the good ones</i>&quot;<p>Can&#x27;t recommend enough this book. Peek inside the mind of the master of writing in Plain English and one of the greatest modern storytellers. For me one of the best non-fiction books out there. Wish more artists produced something like this.
ralphstodomingo将近 5 年前
I&#x27;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?<p>Sure, it&#x27;s all for ensuring we are understood better among ourselves, but I wonder if writing this way makes us cognitively simpler.
评论 #24269879 未加载
评论 #24270465 未加载
评论 #24269952 未加载
评论 #24271671 未加载
评论 #24269696 未加载
评论 #24269565 未加载
SagelyGuru将近 5 年前
Am I the only one who finds The List of Words to Avoid rather depressing? I mean I get what they are trying to do: minimise the number of letters. Yet, language is also about variety and not being really, really dull. Perhaps also about not treating your readers like idiots? Most of those slightly longer words look like perfectly legitimate alternatives in that regard.
评论 #24270964 未加载
评论 #24270919 未加载
评论 #24270863 未加载
评论 #24270876 未加载
评论 #24271519 未加载
GuB-42将近 5 年前
Something not written there: don&#x27;t use acronyms<p>Acronyms are a plague, especially in technical documents. These documents may include a glossary, which it better than nothing, but if an acronym is only used once or twice in a document, why not use the full name instead?<p>Here is a couple of anecdotes:<p>- I once overheard a heated argument between a project manager and some over guy who criticized his work. Turned out, they weren&#x27;t talking about the same project at all, only their acronyms where the same.<p>- In a report that explained why a particular proposal was selected over its competitors, one of the positive points was that their proposal was clearly written, understandable, and didn&#x27;t contain any acronym.
评论 #24269905 未加载
评论 #24270787 未加载
docent8将近 5 年前
This guide makes excellent points. I also recommend this book:<p><a href="https:&#x2F;&#x2F;www.amazon.com&#x2F;Style-Clarity-Chicago-Writing-Publishing&#x2F;dp&#x2F;0226899152" rel="nofollow">https:&#x2F;&#x2F;www.amazon.com&#x2F;Style-Clarity-Chicago-Writing-Publish...</a><p>He says that to achieve clarity, imagine the subject of each sentence as the character of a scene, and the verb as its action. Make sure you hit both character and action within the first 6-10 words of your sentence.<p>Begin each sentence with information that the reader is familiar with, and end it with the new information you want to introduce.<p>That will get you a long way toward creating understanding (and feeling) in the reader.
tjpnz将近 5 年前
As someone working with software engineers for which English is not a first language I cannot emphasise the importance of this enough. I&#x27;ve spent the last year or so consciously working on my writing and it&#x27;s really paid off - especially given the current situation.<p>Never assume anything about your audience&#x27;s understanding. Break everything down into short, concise sentences. If you&#x27;re attempting to get across a non-trivial concept avoid the temptation to use big words - even if you end up having to write more. When you&#x27;re done take another pass and see if you can simplify things further.
karaterobot将近 5 年前
I don&#x27;t write in E-Prime, but I think it raises a valid point: you can often clarify and strengthen your English sentences by avoiding the verb &quot;to be&quot;.<p><a href="https:&#x2F;&#x2F;en.wikipedia.org&#x2F;wiki&#x2F;E-Prime" rel="nofollow">https:&#x2F;&#x2F;en.wikipedia.org&#x2F;wiki&#x2F;E-Prime</a>
评论 #24274301 未加载
评论 #24274865 未加载
powersnail将近 5 年前
Structure is the biggest factor of readability. We’ve seen many English style guides, but they are mostly on a sentence and vocabulary level.<p>A run-on sentence can still be read, just more slowly. An unfamiliar word can be tackled with a dictionary.<p>But if the text isn’t well-organized on the larger scale, there is no hope.
divbzero将近 5 年前
<i>The Elements of Style</i> by Strunk &amp; White offers similar advice: “Vigorous writing is concise. A sentence should contain no unnecessary words, a paragraph no unnecessary sentences, for the same reason that a drawing should have no unnecessary lines and a machine no unnecessary parts.”<p><a href="https:&#x2F;&#x2F;en.wikipedia.org&#x2F;wiki&#x2F;The_Elements_of_Style" rel="nofollow">https:&#x2F;&#x2F;en.wikipedia.org&#x2F;wiki&#x2F;The_Elements_of_Style</a>
评论 #24272968 未加载
rjmunro将近 5 年前
I&#x27;ve heard complaints that while it calls itself &quot;campaign&quot;, implying it&#x27;s a not-for-profit grass roots movement, it is actually a private for-profit company selling publications along with commercial editing and training services.<p><a href="https:&#x2F;&#x2F;beta.companieshouse.gov.uk&#x2F;company&#x2F;02564513" rel="nofollow">https:&#x2F;&#x2F;beta.companieshouse.gov.uk&#x2F;company&#x2F;02564513</a>
secondcoming将近 5 年前
The EU has ended up inventing its own form of English [0]<p>&quot;Over the years, the European institutions have developed a vocabulary that differs from that of any recognised form of English. It includes words that do not exist or are relatively unknown to native English speakers outside the EU institutions and often even to standard spellcheckers&#x2F;grammar checkers (‘planification’, ‘to precise’ or ‘telematics’ for example) and words that are used with a meaning, often derived from other languages, that is not usually found in English dictionaries (‘coherent’ being a case in point). Some words are used with more or less the correct meaning, but in contexts where they would not be used by native speakers (‘homogenise’, for example).&quot;<p>[0] <a href="https:&#x2F;&#x2F;www.eca.europa.eu&#x2F;Other%20publications&#x2F;EN_TERMINOLOGY_PUBLICATION&#x2F;EN_TERMINOLOGY_PUBLICATION.pdf" rel="nofollow">https:&#x2F;&#x2F;www.eca.europa.eu&#x2F;Other%20publications&#x2F;EN_TERMINOLOG...</a>
dragonwriter将近 5 年前
&gt; * A list that is a continuous sentence with several listed points picked out at the beginning, middle or end.<p>&gt; * A list of separate points with an introductory statement (like this list).<p>&gt; In the list above, each point is a complete sentence<p>Er, no, each of those is a (quite long, given the target sentence size the piece argues for) freestanding noun phrase, not a complete sentence.
polimind将近 5 年前
&quot;It&#x27;s faster to write.&quot;<p>Totally disagree with this point. Orwell explains how the exact opposite is true in his &quot;Politics and the English Language.&quot; Vague writing requires only vague thought. Clear writing requires clear thought (as well as editing), and clear thought takes effort. As a writer, you might have to spend more time actually typing unclear and convoluted garbage, but you can basically turn off your brain and just start vomiting words onto the page. To do that asks much less of you than writing clearly does. (Classic example is the Pascal quote: &quot;I apologize for the length of my letter. I didn&#x27;t have time to write a shorter one.&quot;)
paulnechifor将近 5 年前
&gt; whilst (while)<p>I&#x27;m not a native English speaker, but I find it funny how Americans often consider English spellings wrong.<p>I wonder if American Hispanics do the same for Spaniards:<p>&gt; Ahem, it&#x27;s pronounced &quot;ustedes&quot;, not &quot;vosotros&quot;. That&#x27;s not a word.
评论 #24270594 未加载
评论 #24270627 未加载
greentimer将近 5 年前
&quot;Most experts would agree that clear writing should have an average sentence length of 15 to 20 words.&quot;<p>This quote is so preposterous it almost made me want to stop reading the article. Different types of writing should have different sentence lengths. I&#x27;m quite sure the sentence length for a math textbook and a Clorox ad should be different. There&#x27;s a reason it&#x27;s not common practice to measure one&#x27;s average sentence lengths.<p>Like most material written on language, this article says almost nothing and is basically filler. &quot;Don&#x27;t be afraid to give instructions&quot;. &quot;Use lists where appropriate&quot;. Well of course we know we can give instructions! I recently read a famous book called &quot;How to Read a Book&quot; that in a similar vein struggled to find anything non-obvious to say about language. It just comes so naturally to people that it&#x27;s difficult to comment on. This article is coming from an organization called the Plain English Campaign that&#x27;s been around since 1979. I wonder what they can have claimed to have accomplished since then.<p>This article reminded me of arguments I always read in philosophy about tough subjects like radical skepticism where the authors fail to make any points beyond the obvious. Sure, certain knowledge is impossible for humans to attain, but can you say anything else!?
评论 #24271893 未加载
评论 #24272008 未加载
评论 #24271937 未加载
评论 #24271984 未加载
ucarion将近 5 年前
As others here have mentioned, the British government maintains similar guidance:<p><a href="https:&#x2F;&#x2F;www.gov.uk&#x2F;guidance&#x2F;content-design&#x2F;writing-for-gov-uk" rel="nofollow">https:&#x2F;&#x2F;www.gov.uk&#x2F;guidance&#x2F;content-design&#x2F;writing-for-gov-u...</a><p>As does the US federal government:<p><a href="https:&#x2F;&#x2F;plainlanguage.gov&#x2F;" rel="nofollow">https:&#x2F;&#x2F;plainlanguage.gov&#x2F;</a>
jetrink将近 5 年前
At the start of my career, I had some bad tendencies in both writing and programming. I delighted in being clever. I was eager to demonstrate my knowledge and ability. I was more concerned with having fun while writing than serving the reader. It has been educational to be forced to become a reader of my own work, though I read much more of my old code than my old writing.
vonwoodson将近 5 年前
The US government actually put this idea into law 10 years ago: <a href="https:&#x2F;&#x2F;www.govinfo.gov&#x2F;app&#x2F;details&#x2F;PLAW-111publ274" rel="nofollow">https:&#x2F;&#x2F;www.govinfo.gov&#x2F;app&#x2F;details&#x2F;PLAW-111publ274</a><p>More interesting link here: <a href="https:&#x2F;&#x2F;plainlanguage.gov" rel="nofollow">https:&#x2F;&#x2F;plainlanguage.gov</a>
oliver101将近 5 年前
&gt; Most of the UK&#x27;s biggest insurance companies produce policies that explain everything fully in plain English.<p>Is this an argument in favour of plain English? Insurance policy documents are incredibly hard to understand and full of bloat. They are a near-perfect example of how not to write an accessible, informative, and useful document for the intended audience.
评论 #24269365 未加载
评论 #24269496 未加载
kwhitefoot将近 5 年前
&gt; You may not photocopy any guide or pass on electronic copies without our permission.<p>Why do people bother making unenforceable restrictions?
评论 #24270974 未加载
brianmcc将近 5 年前
This Orwell essay stuck with me many years ago, well worth a read: <a href="https:&#x2F;&#x2F;www.orwell.ru&#x2F;library&#x2F;essays&#x2F;politics&#x2F;english&#x2F;e_polit" rel="nofollow">https:&#x2F;&#x2F;www.orwell.ru&#x2F;library&#x2F;essays&#x2F;politics&#x2F;english&#x2F;e_poli...</a>
评论 #24269382 未加载
samthecoy将近 5 年前
If anyone is interested, there is an excellent &quot;plain style&quot; guide which is recommend for much of the British Civil Service. It&#x27;s called &quot;Plain Words&quot;, and is by Sir Ernest Gowers. It&#x27;s received an updated version in recent years.
paulpauper将近 5 年前
Longer sentences are better and more efficient for conveying content when used appropriately. Short sentences mean you have to use too many conjunctions and other filler. Use whatever style you think will be the most effective for readers.
评论 #24269495 未加载
ericsoderstrom将近 5 年前
Was the &quot;avoid nominalization&quot; section intended to be tongue-in-cheek? &quot;Nominalization&quot; is itself a nominalization. If the section followed its own advice it would read &quot;don&#x27;t nominalize [verbs]&quot;
mcguire将近 5 年前
&quot;<i>Apologising: If you are replying to a tricky letter or a complaint, or are dealing with a difficult problem, put yourself in the reader&#x27;s shoes. Be professional, not emotional. You may have to give a firm, unwelcome answer, but be as helpful and polite as possible. If you are going to apologise, do so early. If the problem is your fault, say so. Apologise completely and concisely, sympathetically and sincerely. And whether it is your fault or not, try to emphasise what you can do for the other person.</i>&quot;<p>Wow. Worth the price of entry right there.
amadeuspagel将近 5 年前
&gt; Use lists where appropriate<p>This is so important. How many essays are basically a list of unrelated arguments, but not presented as a list?<p>Things lists make easier:<p>- Refer to specific points.<p>- Skip a point you already understand.<p>Even as I write this, I had to remind myself to express it as a list, rather then a long-winded sentence, which I probably wouldn&#x27;t have if I weren&#x27;t writing specifically to advocate lists. It&#x27;s so deeply ingrained by years of english classes to hide the structure of the text with clauses such as &quot;furthermore&quot;. I even remember being supposed to learn a list of such clauses.
azangru将近 5 年前
&gt; Sadly, thanks to the bureaucrats of public service industries, local councils, banks, building societies, insurance companies and government departments, we have learnt to accept an official style of writing that is inefficient and often unfriendly.<p>Interesting. I thought the use of &quot;thanks to&quot; as a preposition indicating a causal relationship with negative consequences was generally discouraged, because, by its very nature, it&#x27;s a metaphor. But I can&#x27;t find any style guide that would support this.
ximm将近 5 年前
This might be a good spot to point out that there is actually a BCP 47 language tag for this: en-simple. I would love to see more adoption.<p>More info: <a href="https:&#x2F;&#x2F;mailarchive.ietf.org&#x2F;arch&#x2F;msg&#x2F;ietf-languages&#x2F;yVTGZS-6IfBnnk8hmz1n36jVpgM" rel="nofollow">https:&#x2F;&#x2F;mailarchive.ietf.org&#x2F;arch&#x2F;msg&#x2F;ietf-languages&#x2F;yVTGZS-...</a>
jackschultz将近 5 年前
One thing not mentioned that I&#x27;d like to add is avoid using pronouns when you can. Like he, she, it, them, this, that. As soon as you have multiple nouns in when explaining something, you can get screwed. I find myself typing pronouns a lot and when I read back what I wrote, I can see how people get confused. Clarity is so important, and pronouns hurt that.
wombatmobile将近 5 年前
When the purpose of written communication is to direct, instruct or inform, Plain English works wonders.<p>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.
3minus1将近 5 年前
Reminds me of this clip of David Foster Wallace where he discusses puffy words like &quot;prior to&quot; and &quot;utilize&quot; that people use for some reason when a much simpler word works: <a href="https:&#x2F;&#x2F;www.youtube.com&#x2F;watch?v=E_sQrxAorDo" rel="nofollow">https:&#x2F;&#x2F;www.youtube.com&#x2F;watch?v=E_sQrxAorDo</a>
maps7将近 5 年前
I see no proof that &#x27;active&#x27; is better than &#x27;passive&#x27;. Does anyone have any more information on this?
评论 #24270584 未加载
iou将近 5 年前
This looks to be a bit of a distillation of &quot;revising prose&quot; book <a href="https:&#x2F;&#x2F;www.goodreads.com&#x2F;book&#x2F;show&#x2F;1552699.Revising_Prose" rel="nofollow">https:&#x2F;&#x2F;www.goodreads.com&#x2F;book&#x2F;show&#x2F;1552699.Revising_Prose</a>
greenie_beans将近 5 年前
it&#x27;s very hard to write well.<p>one of the best pieces of writing advice i ever heard:<p>your sentences should make sense enough to be taken out of a paragraph and put on a new line for each sentence.<p>if your sentences make sense on a line-by-line basis, then your writing is more understandable.
antipaul将近 5 年前
How in the world am I to do this, when no manager nor leader in my org leads by example?
评论 #24272964 未加载
pbronez将近 5 年前
Another good resource is <a href="https:&#x2F;&#x2F;plainlanguage.gov&#x2F;" rel="nofollow">https:&#x2F;&#x2F;plainlanguage.gov&#x2F;</a><p>I frequently refer writers to specific sections of this site when I edit their technical and marketing documents.
rendall将近 5 年前
I love that they destroy those myths, which have become a pox on beautiful, expressive writing. The &quot;no split infinitive&quot; nonsense-rule has a spectacularly shameful history.
k__将近 5 年前
Reminds me of Wikipedia&#x27;s &quot;simple English&quot; approach.<p>I think the difference is, that simple or basic English only uses the 1000 most common words.
评论 #24269844 未加载
SkyMarshal将近 5 年前
Oblig Scott Adams reference, for anyone who hasn’t seen it yet:<p><a href="https:&#x2F;&#x2F;dilbertblog.typepad.com&#x2F;the_dilbert_blog&#x2F;2007&#x2F;06&#x2F;the_day_you_bec.html" rel="nofollow">https:&#x2F;&#x2F;dilbertblog.typepad.com&#x2F;the_dilbert_blog&#x2F;2007&#x2F;06&#x2F;the...</a>
jwilk将近 5 年前
&quot;a mistake was made&quot; as a good use of passive? Is that a joke?
评论 #24269572 未加载
评论 #24269406 未加载
levosmetalo将近 5 年前
Would like to see a similar suggestion for writing in plain German.
matthewfelgate将近 5 年前
That&#x27;s actually really useful.
motohagiography将近 5 年前
As someone who finds passive language patronizing and insulting, this is a relief to read.
评论 #24270759 未加载
nicbou将近 5 年前
I write technical guides for people who are not native speakers. Using simple vocabulary is easy, but using simple grammar is not.<p>Here&#x27;s a recent article I wrote. It should give you an idea of what I mean: <a href="https:&#x2F;&#x2F;allaboutberlin.com&#x2F;guides&#x2F;car-insurance-germany" rel="nofollow">https:&#x2F;&#x2F;allaboutberlin.com&#x2F;guides&#x2F;car-insurance-germany</a><p>There are a few things I would add to this:<p>---<p>▶ Your readers are here for information, not entertainment. Get to the point.<p>▶ If a paragraph answers a question, the first sentence should be the tl;dr. Highlight it if necessary. [1]<p>▶ Use formatting to make skimming easier. Users don&#x27;t read documents from start to finish. They are looking for specific answers. [2] I spent a lot of time tweaking my website to be more readable.<p>▶ Use can (optional), should (recommended) and must (mandatory) consistently. &quot;It&#x27;s ill-advised to do this, because ...&quot; &gt;&gt;&gt; &quot;You should not do this, because ...&quot;.<p>▶ Avoid run-on sentences. Generally, that means maximum one comma per sentence.<p>▶ Start with the &quot;if&quot; part of the sentence: &quot;If you are over 60, you are not eligible&quot;. It lets people skip sentences that don&#x27;t concern them.<p>▶ Avoid expressions and idioms as much as possible. &quot;If you&#x27;re feeling under the weather, stay home&quot; &gt;&gt;&gt; &quot;If you don&#x27;t feel well, stay home&quot;.<p>▶ Avoid ambiguity between sentences: &quot;The cat sits in the house. It is old.&quot; &gt;&gt;&gt; &quot;The old cat sits in the house&quot;.<p>▶ Use commas generously. It makes sentences easier to digest. I&#x27;m a big fan of the Oxford comma.<p>▶ Use Hemingway [3] to catch some of those mistakes<p>---<p>In other words, DON&#x27;T BE CLEVER. It feels a lot like writing software that will be maintained by novice programmers.<p>Simple language is really important, especially if you deal with the general population. Some people don&#x27;t read well. Some people don&#x27;t speak English well. Some topics are confusing enough on their own.<p>[1] <a href="https:&#x2F;&#x2F;allaboutberlin.com&#x2F;guides&#x2F;anmeldung-in-english-berlin#can-i-do-my-anmeldung-at-a-hotel-or-airBnB" rel="nofollow">https:&#x2F;&#x2F;allaboutberlin.com&#x2F;guides&#x2F;anmeldung-in-english-berli...</a><p>[2] <a href="https:&#x2F;&#x2F;allaboutberlin.com&#x2F;guides&#x2F;how-to-get-a-german-freelance-visa" rel="nofollow">https:&#x2F;&#x2F;allaboutberlin.com&#x2F;guides&#x2F;how-to-get-a-german-freela...</a><p>[3] <a href="http:&#x2F;&#x2F;www.hemingwayapp.com&#x2F;" rel="nofollow">http:&#x2F;&#x2F;www.hemingwayapp.com&#x2F;</a>
bonoboTP将近 5 年前
Why is bad writing so common, though? I think this needs further exploration. What are the incentives of the different actors? TL;DR CYA<p>Clearly, the reader just wants to get the information that is relevant for them personally, with the least cognitive effort. Then move on with their day or to the next step in their workflow.<p>The company&#x2F;government can have various incentives on various levels of the hierarchy&#x2F;bureaucracy.<p>The boss&#x2F;owner may want the company to communicate in a snappy, hip, youthful way, in a friendly and clear tone with no bullshit.<p>However, the person&#x2F;department actually writing the text may want to deflect responsibility, avoid possibilities for blame, keep things vague enough so the onus is on the customer&#x2F;citizen to make sure everything will work out. They don&#x27;t want to deviate from process. The customers&#x2F;citizens should be uniform with no exceptions, because exceptions cause work. If you write too friendly, people will assume they can get favors, that we can start bargaining because they are talking to a real person. Text written in a cold, dispassionate, bureaucratic style will not invite such answers. It signals that things are set in stone, that there is a process in place and we won&#x27;t say A or B, they will have to figure our A vs. B themselves.<p>For example, I&#x27;m a teaching assistant at a university. If I&#x27;m buried under too much work with research and get lots of complicated questions from students, I give vague answers so I can&#x27;t get blamed (&quot;But XY said it would work out this way!&quot;). Also if I use a bunch of official words and formal sentence structure, the student gets the message that I won&#x27;t do the work instead of them: there can be tons of different rules interacting, different study programs have different rule books etc. In the end it&#x27;s their responsibility. I cannot give definitive answers, but experience shows, that writing things plainly often invites more haggling than writing in an official tone.<p>The same thing happens when people talk about medical, legal and other potentially dangerous topics. Even if the actual answer is straightforward and will apply in 99% of the cases, nobody gets fired for being too cautious. &quot;Nah don&#x27;t do that&quot; is the easiest thing to say. Ask your doctor. Ask an attorney. Check the laws of your region.<p>To write plain and clear text, you need to leave all these caveats out. But people will jump at every opportunity to try to shift the blame, and if you weren&#x27;t careful, it will accumulate on <i>your</i> desk. To avoid this, orgs and lawmakers should make sure to reduce the legal responsibility for saying things.<p>For example I know a(n underpaid) lawyer working for a governmental institution in Hungary. They are in the communications department and give advice on certain legal things to ordinary citizens phoning in or over email. Fortunately, the laws and rules are set up such that they cannot be blamed for answering wrong or not hedging enough, they can write as they would to a family member. It&#x27;s not &quot;legal advice&quot;, because you can&#x27;t know <i>all</i> circumstances from just an email question. At best, the person or company who acts on such advice can use the email exchange to demonstrate due diligence. They at least tried. Still, it&#x27;s fully their responsibility to check and interpret the law.<p>Therefore, unless you shield your writers&#x2F;departments from blame by similar explicit rules, they will shield themselves through vaguery and hedging and complicated writing.