A few years ago, I was invited to give a few technical writing lectures at The University of Tokyo. Now, I am happy to share these notes and tips with you in case they help you achieve your writing goals. Many thanks to the writing centers that allowed me to share their sage advice with you in this forum.
Sunday, January 6, 2019
Show them the money
One of the hardest things from my Japanese clients to understand is that American people want to hear a hopeful story. It's okay to talk about Japan lagging behind in this area or that area when trying to convince your company to sponsor your MBA or when applying for a Fulbright scholarship or a similar grant. However, when writing for or speaking with admissions officers, tell them a story about the opportunity that you hope to capture.
Sunday, November 4, 2018
Include first and last names when mentioning alumni in your essay
Include first and last names when mentioning alumni in your essay
Tip: Always refer to current students or alumni by their full name and year of graduation.
Tip: Always refer to current students or alumni by their full name and year of graduation.
Reason: Sometimes, admissions office readers only know someone's first name.
IN ESSAYS
IN LETTERS of RECOMMENDATION
Mr vs Mr.
Too many clients write Mr.Smith, which is always incorrect in both US and UK English.
IN ESSAYS
- Student names: Always refer to current students or alumni by their full name. Sometimes, adcom readers only know someone's first name, especially at schools like Kellogg and Tuck. Write like this: Vince Ricci (MBA '15)
- School name: similarly, in your goals essay, the first time you write a school's name, spell it out officially as the school does e.g. The Kellogg School of Management. Afterward, you can just call it Kellogg.
IN LETTERS of RECOMMENDATION
- The first time your recommender mentions you, he should write your full name, like this: "I first met Mr. Vince Ricci in 2002." Afterward, he can refer to you as just Mr. Ricci (or Vince if a peer / casual recommender)
- I am writing to you with regard to [Mr./Ms. Full Name], who has requested that I write a letter of recommendation on [his/her] behalf.
Mr vs Mr.
- In British English, abbreviated titles that end with the same letter as the word being abbreviated do not take a full stop (period): “Mr” but “Prof.”
- On the other hand, in American English, all titles take a period: “Mr.” and “Prof.”
- Either way, be sure to add a space after Mr or Mr.
Too many clients write Mr.Smith, which is always incorrect in both US and UK English.
Friday, August 31, 2018
How to markup an essay
Q: What do these editing colors and symbols mean?
A: I often use the following highlight colors to indicate certain writing issues
ORANGE = wdy = wordy, verbose
YELLOW = grammar issues, including misplaced modifiers, usage, spelling, articles, agreement, capitalization
GREEN = vague, illogical, imprecise or misleading
BLUE = logic or transition issues
PINK = awkward or passive
A: I often use the following highlight colors to indicate certain writing issues
ORANGE = wdy = wordy, verbose
- wordy: too many words express a desired thought or concept; try to shorten or condense the phrasing or simply omit unnecessary words; also repetitive and/or run-on sentences
- Please read these tips to make your writing concise and powerful http://techwritingtodai.blogspot.jp/2012/04/wordy.html
YELLOW = grammar issues, including misplaced modifiers, usage, spelling, articles, agreement, capitalization
- agr = agreement, either subject/verb or pronoun/antecedent
- art = articles: Should I use an indefinite article (a/an) or a definite article (the)? http://techwritingtodai.blogspot.jp/2011/04/articles.html
- cs = comma splice
- dm = dangling modifier
- frag = [sentence] fragment, incomplete sentence: There is part of a sentence, but not enough to make a complete one.
- cap = capitalize, use uppercase letters (please read this post http://techwritingtodai.blogspot.jp/2011/03/acronyms.html)
- lc = use lowercase letter (please read this post http://techwritingtodai.blogspot.jp/2011/03/acronyms.html)
- no = number: A number is used incorrectly in text. A common error is beginning a sentence with a number in numerical form. Although sentences may begin with numbers in spelled-out form, numbers in numerical form are not used to begin sentences. The second most common error is failing to spell out numbers less than ten. (http://techwritingtodai.blogspot.jp/2011/03/writingnumbers.html)
- sp = spelling error or "spell out": This signal indicates a spelling mistake, a typographical error, the improper use of an abbreviation instead of the complete word or words, or the failure to spell out numbers less than ten.
- spchk = use spellcheck (Please learn to avoid these common spelling and grammar errors (not picked up by spell checkers) http://techwritingtodai.blogspot.jp/2013/09/common-spelling-and-grammar-errors-not.html
- v = verb form or forms are incorrect. The most common error of this type is disagreement between the number of the subject of the sentence and the number of the verb ("she see" or "they talks"). Another common problem occurs in series of nouns with "and" or "or;" in "or" series the number of the verb should agree with the noun that is closest to the verb in the sentence. Correct: "A lapse, an error, or omissions in text make it difficult to read." (In this sentence, the plural verb form "make" is correct because the plural noun "omissions" is closest to the verb.)
- ww = wrong word
- tr = transpose letters or words
- # = add space
GREEN = vague, illogical, imprecise or misleading
- Vague: add prepositional phrases and details to fix the context and define the issues
- va = vague: A paragraph, sentence, clause, phrase, or word is vague, nonspecific, imprecise, or misleading. The most common error is failure to include short prepositional phrases that tie things down. Vague (depending on context): "The court refused to decide the issue." Precise: "The court refused to decide the issue of proximate cause."
- Solution: show, don't tell (http://techwritingtodai.blogspot.jp/2011/03/sdt.html)
- This... what? Professor John Cochrane at The University of Chicago Booth School of Business says, you should clothe the naked “this.” “This” should always have something following it. “This example shows that....” is fine. More generally, this rule helps you to avoid an unclear antecedent to the “this.” Often there are three or more things in recent memory that “this” could point to. http://techwritingtodai.blogspot.jp/2014/07/this-what.html
BLUE = logic or transition issues
- not believable, not credible (esp. in recommendation letters)
- The greatest mistake that I see applicants make when drafting bullet points for letters of recommendation: they cross the credibility line by referencing information the recommender is unlikely to know. Recommenders can only mention what you said and did, not what you thought and felt. How can a recommender know your inner motivations unless you told him? And even if you told him, why would he feel the need to mention such information in a letter of recommendation? Bottom line: He should discuss what you said (add real dialogue) and did (actions and results) instead of what you thought or felt.
- trans = transition problem: A transition between paragraphs, arguments, or sections of the writing is nonexistent, abrupt, weak, lame or misleading. Think about the logical relationship between the parts that need connecting and try to write a smooth and helpful transition. Good transitions are based upon ideas and their logical relationship, not just clever or stock phrases.
- Please read these tips to improve your transitions http://techwritingtodai.blogspot.jp/2012/04/transitions.html
PINK = awkward or passive
- awkward phrasing, although not grammatically incorrect. Most common: words with slightly inapposite meaning, too many words to express a particular concept, or awkward (but not technically incorrect) grammatical construction
- pv = passive voice: Passive constructions ("the case was decided" or "it was determined that...") are grammatically correct but weak and often confusing. They are useful only when the subject of the verb is unknown or indefinite or the writer wishes to conceal the subject.
- Otherwise, passive voice—particularly if used repeatedly—is a sign of wooden and heavy writing.
- Solution: There are five reasons to use passive voice. Please learn them! http://techwritingtodai.blogspot.jp/2011/04/passive-voice.html
Monday, May 1, 2017
This... what?
THIS... WHAT?
To quote Professor John Cochrane at The University of Chicago Booth School of Business, you should clothe the naked “this.”
“This” should always have something following it. “This example shows that....” is fine. More generally, this rule helps you to avoid an unclear antecedent to the “this.” Often there are three or more things in recent memory that “this” could point to.
In grammar lexicon, the above issue is often marked as "unclear antecedent."
Sometimes an antecedent is unclear not because there are multiple nouns that a pronoun may refer to, but because the noun that the pronoun refers to has not been stated. This error is especially common when writers use first-person plural pronouns—we, us, our, and ours—to imply unity between the writer and the readers.
Identifying and Addressing Unclear Pronouns and Antecedents
https://writingcommons.org/.../1237-identifying-and-addressing-unclear-pronouns-antec...
Subscribe to:
Posts (Atom)
Featured Post
What are the five reasons to use passive voice?
USE ACTIVE VOICE As listed below, there are only 5 reasons one should EVER use passive voice. If you don't need to use passive voi...
-
MAIN IDEA and CONTRIBUTION What is a contribution? · A contribution includes an addition to your field’s overall knowledge....
-
PLEASE NOTE: USE THESE TIPS FOR ESSAYS. THIS ADVICE DOES NOT APPLY TO RESUMES, CVs, AND APPLICATION FORMS, WHERE IT IS BEST TO CONSERVE SPAC...