技术写作实战(5)
作者:Dan Wen | 分类:写作风格 | 2014-3-29 22:25:47
请按照技术写作的要求修改下面的句子:
- The default value of the <duration> parameter of this JS function is 100.
- Remove the selected record from the list by clicking Drop.
- You can create your maintenance plan with Schedule Editor.
- Enter the record number that you want to search for.
- Click on Next (or press on the Enter key).
查看答案
- In this JS function, the default value of the <duration> parameter is 100.
尽量避免直接连接两个或以上的介词短语,特别是相同介词的短语,因为这样会减弱句子的易读性,甚至会使读者误解。 - Click Drop to remove the selected record from the list.
许多带有 by doing 介宾短语的句子都可以进行调整,使句子的表达更清晰简洁。另外,介词引导的成分一般都被认为是句子中较为不重要的部分,如果这部分内容正是你想要强调的部分,就更应该考虑调整句子结构了。 - You can use Schedule Editor to create your maintenance plan.
With 是一个使用范围很广的介词,但是有时候不是很易于理解或翻译,可能的话,考虑使用更直接的表达来代替 with。 - [No change]
在技术写作中,以介词结束一个句子一般是可接受的(少数公司的 writing style guide 不允许用介词结束句子)。我的的首要目的是让句子更好理解。如果原例句改成下面这样如何?
Enter the record number for which you want to search.
这也是正确和可以接受的,只是这样的表达更为正式(一些人甚至会觉得有些蹩脚和做作),而且 search for 这个短语被分割得比较远,一定程度上增大了理解和翻译句子的难度。 - Click Next (or press Enter).
对于用户的输入动作,比如 click 和 press,动词后面不需要加上 on。
标签:技术写作实战 Writing Style 技术写作入门 技术写作
本文永久链接:
http://www.technicalwriter.cn/blog/post/tech-writing-practice-005.html
Google+
2. Click Drop to remove the selected record from the list.
Revised: To remove the selected record from the list, click Drop.
Reason: Put action purpose before action. <我们在用Acrolinx检查语法,其中的有一条rule就是这点。Acrolinx支持定制语法检查点,这点也可能是我司特有的)
3. You can create your maintenance plan with Schedule Editor.
我会这样改:
Creating a maintenance plan using Schedule Editor.
4. Enter the record number that you want to search for.
According to minimalism writing, I will change it to:
Enter a record number as needed or Enter a record number.
1. The default value of JS function's <duration> parameter is 100.
2. Click Drop to remove the selected record from the list.
3. Use schedule Editor to create your maintenance plan.
4. Enter the record number and search.
5. Click Next (or press the Enter key).
--> The parameter <duration> in the JS function has the default value of 100.
2. Remove the selected record from the list by clicking Drop.
--> To remove the selected record from the list, click Drop.
3. You can create your maintenance plan with Schedule Editor.
--> To create your maintenance plan, use Schedule Editor.
4. Enter the record number that you want to search for.
Click on Next (or press on the Enter key).
--> To search, enter the record number, then click Next or press Enter.