【学习笔记】The Global English Style Guide (I)

拿到这本Style guide有一年多了,零星看了些章节,里面example与guidelines非常丰富--看时觉得很受启发,但在实际写作中却总是记不住,太琐碎。这个国庆假期,基于从头到尾把它看了一遍,记录下对我有启示的:比如,解答了我语法困惑的原则,eliminate ambiguity的一些原则。

What is Global English?

Global English refers to written English that an author has optimized for a global audience by following guidelines that go beyond what is found in conventional style guides.

The Cardinal Rule of Global English

Don't make any changes that will sound unnatural to native speakers of English.

Corollary

There is almost always a natural-sounding alternative if you are creative enough (and if you have enough time) to find it!

不及物动词演变为及物动词

Sometimes a verb that was formerly used only transitively comes into common usage as an intransitive verb, or vice versa. In such cases, consider accepting the change in usage.

例如 ,shut down, initialize, authenticate, complete。以前都是vt,现在都可以用作vi.

Examples:

- Please wait while your computer shuts down

- The statements are executed immediately after the software has fully initialized.

- End users must authenticate to the service.

- ...until the installation completes.

Use singular and plural nouns correctly

Example:

Before: All the data items shown in Figure 7 have a numeric value. (illogical and incorrect)

After:

-  All the data items shown in Figure 7 have the same numeric value.

-  All the data items shown in Figure 7 have numeric values.

-  Each data item shown in Figure 7 has a numeric value.

Use 's to show possession

Using 's is a perfectly suitable way of clarifying some noun phrases.

!!! Disregard the old-fashioned prohibition against using 's with nouns that denote inanimate objects.

Before: The WINDOW field data area was not defined because not enough memory was available.

After: The WINDOW field's data area was not defined because not enough memory was available.

Clarify what each relative clause is modifying (esp. when modifying prepositional phrases) (`限定从句` for 介词短词 指定不明)

A relative clause doesn't always immediately follow the noun phrase that it modifies. One context in which a relative clause is likely to be ambiguous or confusing is when it follows one or more prepositional phrases.

Before: Click Overview to view short descriptions of the products that include information links.

Note: The relative clause could be modifying either the closest preceding noun phrase (products) or a noun phrase that occurs earlier in the sentence (description).

After: Click Overview to view short descriptions of the products. Each description includes links to more detailed information.

In some cases, the verb in the relative clause agrees in number with the noun phrase that the relative clause modifies. Then there is no ambiguity.

The Edit window accepts lines in a DATALINES statement that are no longer than 256 characters. (Unambiguous)

If you change chapters of a document that someone else has checked out, you won't be able to save your changes. (Ambiguous)

Make sure readers can identify what each pronoun refers to (`代词`指代不明)

When "it" has more than one possible referent, you can often replace it with a form of the noun phrase that it refers to.

Before: Once you define the basic structure of your table, enhancing it is easy.

After: Once you define the basic structure of your table, enhancing the table is easy. (类似前面restrictive clause与prepositional nouns组合时带来的ambiguity.)

Before: You can insert commas and blanks in a bit mask for readability without affecting its meanings.

After: You can insert commas and blanks in a bit mask for readability without affecting the bit mask's meanings.

Note: Even its can refer only to the singular noun phrase bit mask, the sentence is easier to comprehend if you repeat the noun phrase instead of using its.

Before: When the syntax analyzer reaches the RUN statement, it passes the entire program to the compiler.

? After: When the syntax analyzer reaches the RUN statement, the syntax analyzer passes the entire program to the compiler. (最近原则的应用`反例`sounds unnatural. 分析:当从句中的it是指代主句中的主语,无需重复noun)

Note: The resulting sentence sounds unnatural. This fact indicates that, to readers, the context made the pronoun's referent clear.

Before: The rows in the data set must either be sorted by all the variables that you specify, or they must be indexed appropriately.

? After: The rows in the data set must either be sorted by all the variables that you specify, or the rows must be indexed appropriately. (最近原则的应用`反例`sounds awkward 分析:当从句中的pronoun是指代主句中的主语,无需重复noun.)

Note: Replacing a potential ambiguous pronoun with the noun that it refers to sometimes sounds awkward.

Clarify which parts of a sentence are being joined by AND or OR (Scope of Conjunction)

当遇到and或or连接的两个句子或短语时,停一停,想一想,是否会有歧义。是否需要添加syntactic cue.

当And或Or后跟着的词既可作名词又可作动词时:

Before: Don't dip your bread or roll in your soup.

After: Don't dip your bread or your roll in your soup.

Before: The application can use the window to establish a dialog with the user and format text responses.

After (Option 1): The application can use the window to establish a dialog with the user and to format text responses.

After (Option 2):  The application can use the window to establish a dialog with the user and can format text responses.

There is no need to re-sort a table when rows are modified or added. (No potential for misreading)

However, if two different grammatical constructions are being joined, then insert a syntactic cue even if the two parts are close together.

Before: The tags are known and built into the browser.

After: The tags are known and are built into the browser. (Note: known is an adjective, and built is a participal that forms the passive verb are built.)

题外话

这一段家事公司事都挺多的,应了一句老话:when it rains it pours。10月初,公司go-private了(被美国两家VC买下从纳市退市,与另一家公司合并)。资本逐利,估计“精简组织机构”一直要持续到11月。当初选择它时,LG的顾虑是选择美资企业在如今的市道下可能一两年内就会面临裁员的命运。

这个十一假期里,时常会想想南京文档组的命运。作为文档这种公共部门,一般是本地研发部门还在,它就会保留,但也不排除印度伙伴慢慢接过我们手中的产品。自己被layoff的可能性也不能说没有。不过,无论是什么结局,于我,都会平静接受。

回头看这一年多的工作生长历程,我并不后悔放弃深圳相对轻松与稳定的工作。因为,目前的这份工作让我终于回到自己的技术专业领域,认识到自己的英文写作的不足,获得了以前不曾有过的1:1技术写作指导,遇到了可以真正探讨英文写作与技术写作的同事,增长了写作领域知识,激起我继续学习的热情 ... 这些都让我觉这次工作经历很宝贵,如果它是我的英文技术写作生涯的最后一笔,那也算是为此画下了一个圆满的句号! 

这份工作的确很有挑战,快节奏的产品上线速度对写作质量与效率都提出了很高的要求,身在其中,必须全心投入,也就意味着生活基本围绕着工作转。以往我对美食对营养的那点小爱好小乐趣,已无力顾及。回想起上一份工作,上班全力工作,下班完全抛开工作的生活,也很让人怀念。不过,如果没有真实体验过,又怎么知道哪种生活是你当下想要的呢?活在当下吧,回忆总是记得些美好的画面,那时的种种苦恼也不少。

节后,自在的work from home也要结束了,全体员工工作日必须回办公室上班。这一段都在慢慢做心理建设,如何消化与面对。有三四年没有正儿八经在办公室上班了。Benefit很多,每天省却一两个小时的通勤时间,三四天不用洗头,运动服包打天下,照顾家庭,风雨无忧... Drawback就是缺少人际交流,每天大部分时间困于这几十平米的套间里。慢慢来吧...

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 218,284评论 6 506
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,115评论 3 395
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 164,614评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,671评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,699评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,562评论 1 305
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,309评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,223评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,668评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,859评论 3 336
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,981评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,705评论 5 347
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,310评论 3 330
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,904评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,023评论 1 270
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,146评论 3 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,933评论 2 355

推荐阅读更多精彩内容