在线咨询
eetop公众号 创芯大讲堂 创芯人才网
切换到宽版

EETOP 创芯网论坛 (原名:电子顶级开发网)

手机号码,快捷登录

手机号码,快捷登录

找回密码

  登录   注册  

快捷导航
搜帖子
查看: 3345|回复: 9

Dave Patterson's Writing Advice

[复制链接]
发表于 2007-7-19 12:59:23 | 显示全部楼层 |阅读模式

马上注册,结交更多好友,享用更多功能,让你轻松玩转社区。

您需要 登录 才可以下载或查看,没有账号?注册

x
  •     My first advice is to read aloud what you have written. Generally your ear is better than your eyes, and if you read it aloud you are much more likely to find awkward sentences, bad tenses, and other errors.
    I find many people are good at sentences, but less good at forming paragraphs. Ousterhout has a solid rule, which led me to write shorter paragraphs. A paragraph is about a single idea, with a single key topic sentence. This sentence is almost always the first, but sometimes the last sentence of the paragraph, and the rest of the sentences somehow support that topic sentence. If it works, you can get a quick summary of a section just by reading the topic sentences.]
    I get most of my specific advice from Strunk and White, "Elements of Style", which I call "S&W," I try to read it every few years to learn things. I'll quote from it here on common errors I find in grad student writing. (The proper citation is "The elements of style," by William Strunk, Jr. ; with revisions, an introduction, and a chapter on writing by E.B. White ; [foreword by Roger Angell]. 4th ed. Boston : Allyn and Bacon, c1999. xviii, 105 p. ) My most recent incite is to use the Grammar Checking in M/S Word 98. I did this in my chapters for the 3/e of CA:AQA, which consisted of copying and pasting the text from Framemaker into Word. To turn on the tool, check the "Check grammar" box and then click on options. I selected "Technical" for Writing style (which was at the bottom of the menu, with the default being casual); I think this was important, as it was much more helpful after I selected this option. (I turned off the spelling checking since it was spell checked in Frame.) I then selected "Settings" to see what I wanted it to check. It found passive voice problems, too long setences, and verb-noun tense problems among other problems. Many of the issues listed below are checked in Word. It really helped.


    ? Active voice: (S&W rule 14) For example, use "Figure X shows ..." rather than "... as shown in Figure X."
    Also, it is much better to mention a Figure that summarizes a lot of information early in a paragraph rather than go into details and mention the figure at the end, as early mention gives the reader a framework to refer to while reading the text.


    ? Ambiguous use of pronoun "This" to summarize sense of previous sentence. (S&W page 16)
    The writing is virtually always clearer if you sane for every occurrence of "This" (case sensitive) or "This is" and put a noun after "This" to make it clear what you are referring to. I'll find sentences where I'm not really sure what I meant, which must make it harder for the reader! So search for "This " in your text to see if a noun follows.


    ? "While" instead of "and", "but", "although". (S&W pages 63-64)
    In general while should be used only in the strict sense of "during the time time"; S&W give several better ways to convey the same message. So search for "While " in your text to see if the sentence is about time, or could be replaced with "Although".


    ? A single numbered subsection
    Its strange to have a single subsection (e.g., 5.2.1 in section 5.2). Why do you need to number it if there is only one? Either eliminate the single subsection, or change the part that precedes the subsection into a second subsection


    ? Refering to Chapters, Figures, Tables.
    Its not a easy to understand rule, but normally these names are capitalized when used to refer to a specifuc number. So its Chapter 1, Table 3.1, Figure 1.2. I have seen some people not capitalize section 1, but I don't understand the logic behind it, so I'd capitalize it also.


    ? Little things: label percentages in tables with %, dollars in tables with $
    Its much easier to look at a list of numbers that are percetages and immediately realize that its a column of percetages if every number has a % after it, vs. just labeling the column as Percent. No one will be confused that this is percent of a percent of if you do both. Similar arguments for prices and $.


    ? Numbers spelled out vs. numerical.
    The general rule of thumb is to spell out one to ten and use numbers for numbers for 11 and up. However, I find its much better to consistently use numbers when the reader might naturally compare or do arithmetic with the numbers with a sentence or a paragraph. For example, " The 8-processor case (model 370) needs only 4 computers to hold 32 processors. " Blindly following the rule of thumb would change the sentence to " The eight-processor case (model 370) needs only four computers to hold 32 processors. " Its easier to read and understand we use numbers (8*4=32) instead of words (eight*four=32).


    ? In case you are not familiar, learn about INSPEC from MELVYL so as to make it MUCH easier to get proper citations. I would adopt its citation style to reduce the amount of typing.

    If you would like more writing advice, other books are:
    ? Frederick Crews and Sandra Schor, "The Borzoi Handbook for Writers (2nd edition)", Alfred A. Knopf Inc., 1989.

    ? Linda Flower, "Problem Solving Strategies for Writing (3rd edition)", Harcourt Brace Jovanovich, 1989.
    There are probably newer editions of these books.

发表于 2008-1-10 14:05:46 | 显示全部楼层
谢谢分享
头像被屏蔽
发表于 2008-2-27 16:30:25 | 显示全部楼层
提示: 作者被禁止或删除 内容自动屏蔽
头像被屏蔽
发表于 2008-3-4 08:28:03 | 显示全部楼层
提示: 作者被禁止或删除 内容自动屏蔽
发表于 2009-5-30 01:35:27 | 显示全部楼层
发表于 2009-5-30 01:37:31 | 显示全部楼层
发表于 2009-5-30 01:43:32 | 显示全部楼层
发表于 2009-6-6 13:25:06 | 显示全部楼层
thank you very much!!
发表于 2009-6-6 15:49:21 | 显示全部楼层
谢谢分享
发表于 2009-6-22 04:30:11 | 显示全部楼层
thank you so much!
您需要登录后才可以回帖 登录 | 注册

本版积分规则

关闭

站长推荐 上一条 /1 下一条

小黑屋| 关于我们| 联系我们| 在线咨询| 隐私声明| EETOP 创芯网
( 京ICP备:10050787号 京公网安备:11010502037710 )

GMT+8, 2024-3-28 17:02 , Processed in 0.043169 second(s), 11 queries , Gzip On, Redis On.

eetop公众号 创芯大讲堂 创芯人才网
快速回复 返回顶部 返回列表