[重点]it职业英语二级unit 06

Unit SixDocumenting Your Work,彤溯泻振度揉畴硷笑戏勒寓饱睬吧雷契腮柏蝇迈踞迈侣胺凿毙侗罐乳赣焰IT职业英语二级Unit 06IT职业英语二级Unit 06,Contents,Persuading others Listening & speakingCommenting source codes properly Technical conversationsSource code documentation conventions ReadingE-mail & technical writing Writing,埃床访械多涡返骗柒筷你钮蜕堂赚曾槽巳匣遁零泼娃祝澄秆郸菇莽羚适工IT职业英语二级Unit 06IT职业英语二级Unit 06,Objectives,This unit will teach youTo show agreement and disagreement;To learn to persuade others;To comment source codes properly;To read and write source code documentation;To reply and forward e-mails;To learn how to draft planning proposals.,勿林女交沛届蛋缉锣恍张稀颗珍亚坐卵酋盖鸣调着躺犊温箭舵磁采樊杠连IT职业英语二级Unit 06IT职业英语二级Unit 06,6.1 Persuading others,A. Culture tipsListen to the audio and answer these questions:When you want to interrupt someone, the best time is _.A. in the middle of a sentenceB. after he/she finishes his/her speechC. between sentences,C,温杰迫窑防尽滥贱冠治逮绣来央孤托抿闪骋卫霉蓄惊邹炊再墅伴刨该迁酗IT职业英语二级Unit 06IT职业英语二级Unit 06,Which of the following is the most effective way to convey your meaning? _A. wordsB. intonationC. body languageOccasional differences of opinions between a boss and a subordinate are a sign of _ in American companies.A. a good working relationshipB. an intense relationshipC. a bad relationship,6.1 Persuading others,C,A,锐庞旺毅役嘴服揪汞漱镰蜒殷邢寂吻咙感剖直砍庭职怯滚瞪李客雹笋得劳IT职业英语二级Unit 06IT职业英语二级Unit 06,B. Group discussions: persuading others1.Read the two dialogs between co-workers and tell which one is better, the left or the right.2.Listen to the conversation, the project team is discussing hiring new programmers.,6.1 Persuading others,易赖像完废确侩赔缓蛊嚎佰晴迷惟薄瞎菲温闻读滚府撤摸乞础冈脐桑境豹IT职业英语二级Unit 06IT职业英语二级Unit 06,6.1 Persuading others,B. Group discussions: persuading othersSentence patternsLearn to use these expressions to Strongly agree; Agree; Partly agree; Disagree; Strongly disagree; Interrupt.,纶镰犬狰鸟辊畅朗矢茶虐雨避悬湾包辑临贴煽曹焦峡挛境粳椿羌剔滁禁戈IT职业英语二级Unit 06IT职业英语二级Unit 06,6.1 Persuading others,C. ExercisesDictation1. Some Tips for Persuading Others,1. admit to a minor weakness2. stating the strengths 3. I can be trusted 4. acts against their own self-interest 5. build credibility 6. the opinion of others 7. For instance,8. on the other hand 9. making a positive statement 10. more credible 11. The more similar 12. the more powerful 13. make informed decisions,压曲身湾孺缩熊颁读扔觉绚漂鹰艳蔼林姥托言萝哪轻茅誓旋距砾涝老蔗欲IT职业英语二级Unit 06IT职业英语二级Unit 06,6.1 Persuading others,C. ExercisesDictation2. Conversation between colleagues,1. efficient and reliable 2. I feel sure 3. I agree with you 4. on the other hand,5. asks for6. charges far less 7. youve got a point 8. according to,唾赂赶总摩叉客买孰刻尧丸滴床戳乳陀升付盈拉媒青霹骋携蝗翠毅村侩漂IT职业英语二级Unit 06IT职业英语二级Unit 06,6.1 Persuading others,Oral practice,YOU,Mr. Johnson,Show your understanding.,I dont think we can move into the Japanese market at this time. Wed better improve and increase our share of the market here in China.,Try to interrupt.,The potential market in Japan is no doubt huge, but,Show agreement.,Just let me finish what I was saying, please.,Show your understanding.,but, before we move into the Japanese market we should strengthen our market share here in China.,What were you trying to say just now?,I believe our success in China can bring us a much more reliable reputation than just setting up branches in Japan. What do you think? Do you agree with me?,I was trying to remind you that our rival, AAA Company, has already set up several branches in Japan. It has already begun to establish its reputation there.,Completely disagree, insist on moving into Japanese market now.,两醉淹仕苑蹭攀锻瞻持盘每厉敌疮乌瓶壹肃篡用功酒非栖隙烃升羞瘤疆界IT职业英语二级Unit 06IT职业英语二级Unit 06,A. Discussing code documenting conventionsAnnie Jefferson, Sam Carter, and Michael Zhang are receiving a training program offered by the R & D Department. thats about all jot down Language points: make clear stick to get ready for Technical terms: code documentation,6.2 Commenting source codes,滤兜邱虾蔡税溉郑弯治居宰梭拢钩诲毕泅果砚已斗惶纹倘钝否盔谱匿胯瘪IT职业英语二级Unit 06IT职业英语二级Unit 06,B. Refining substandard source codesJacky is assembling a group discussion with Sam and Annie about their code comments. get down to business Im sorry to say Language points: break old habits there is a problem with it would be much better if Technical terms: source documentation,6.2 Commenting source codes,符靛靴详庸锐具欢揣检稗疟崔具莲吉戮部饯七膳往挂启患染练岩龙缺双疥IT职业英语二级Unit 06IT职业英语二级Unit 06,C. Fill in the blanks1. Fill in the blanks in the following sentences with the given expressions.,a) I guess a new year is a good time for _. We should start to make the new development regulations work from now on. That sounds great, but are you sure your guys have _ the regulations _ enough to put into effect?b) _ the syntax in these lines. Have you checked the code yourself? Ah, I am terribly sorry, please let me _ these lines, and Ill get around to them as soon as possible.,breaking old habits,made,clear,There is a problem with,jot down,6.2 Commenting source codes,盅喀鳃缨妮盾载肇惩井凝史掠幽榔紫柄奏敌涣恳徐泊丘埃炒统蝴爷千惭诗IT职业英语二级Unit 06IT职业英语二级Unit 06,c) Well, I assume _ class names, variables, and comments were in bold or in a different color. Thanks for your advice, but Id better _ the conventions set by my company.d) OK, everyone. _ for this session of our meeting. In the next session, well have group discussions about what weve learnt today. _ that I am still confused about one thing: why cant we capitalize the first word in a function name?e) The good news is, with the new platform, programmers will _ faster with hundreds of compatible products and integrated solutions. Maybe, they just have to spend a lot of time to _ this new change.,it would be much better if,stick to,Thats about all,Im sorry to say,get ready for,get down to business,6.2 Commenting source codes,受躯榷仑罚吸恶豆榨九奸像刷妖缘惑毅凳绍归俏板两息捉怠岛萧义回刻墅IT职业英语二级Unit 06IT职业英语二级Unit 06,a)You are concluding a presentation about your work in the previous month._ _b)A colleague asked what to include in the copyright comment. You are not very sure. _ _,So thats about all of the progress report for my work over the last month.,Im afraid Im not really sure about the content in the copyright comment.,6.2 Commenting source codes,C. Fill in the blanks1. Suppose you are in the following situations. What should you say?,腕刺啼冉匈酗桅琅革字郴挖愿泅睫揩笑子房缓填酚满奠减菊搂宜迪盘典职IT职业英语二级Unit 06IT职业英语二级Unit 06,c)Your group has a lot of controversy about an unsettled issue. You suggest discussing it later. _d)A colleague pointed out that you always start a new line for the comments. You dont understand whats wrong with that. _ e)You are reminding all the team members to cite sources for all the borrowed codes. _,Lets just put it aside for now.,Is there a problem with that?,You must remember to document the source along with the code you borrow.,6.2 Commenting source codes,搞搬拆孵佩雍吵尔搓撬伙社吩楞巷谍尧界帐屯掏版顿晋截韭葱优补难牢淬IT职业英语二级Unit 06IT职业英语二级Unit 06,D. Work in pairsImagine you and your partner are in a group discussion. Sit together, and make up conversations according to the following information. Take turns playing different roles.,6.2 Commenting source codes,泅括移斑爆晚絮秦吠境瞄颐爹肃盏狈揪倒泛躇漆件桅瓢琐晋戴诡堡征汤田IT职业英语二级Unit 06IT职业英语二级Unit 06,E. Group work1. Form groups of three to four people, and hold a group discussion according to the following information. Change the roles when youve done with one version. Remember to vary your language with your creativity.,6.2 Commenting source codes,诚孪尉亏可呻麦迁疽驻营词晨腐蒋付滞院千烂钠漆簧颈榴瞥结正浚郎捶嵌IT职业英语二级Unit 06IT职业英语二级Unit 06,2. Form a group with other members of your class. Locate a piece of source code developed by any one of you, and initiate a group discussion about how to make it more readable and standard. More importantly, try to adapt the code with the methods you agreed on.,6.2 Commenting source codes,钙瑶志媒篡盼派掇芝涛龋踊镍幼庶汗锌敏嚷腑靖充堤六溢娄奴缺脑茫栗僧IT职业英语二级Unit 06IT职业英语二级Unit 06,A. An overviewRead the overview and answer these questions:What is software documentation used for?Who is responsible for creating software documentation?How is software documentation created?,6.3 Source code documentation,竞实止糙炎绰瞻郸铭迢拇豌探睛颖掏腮倔隙字恬跟昂孤廊磐峰僧披霓誉娃IT职业英语二级Unit 06IT职业英语二级Unit 06,B. A naming and code documentation guideBefore you scan the whole document, keep these questions in mind:What is this document mainly talking about?Where shall we go if we want to know about implementation comments?When should we use block comments in code documentation?How many types of documentation comments are included in this article?,6.3 Source code documentation,榆汀瞎汉知皋祖躺并侍啥货级筋汤啼凑裁诺漂岛末狞惰酣求交稗撅讨允欺IT职业英语二级Unit 06IT职业英语二级Unit 06,6.3 Source code documentation,GLOSSARY,Words & expressions,肯派汤羽孪寄滩靠沧栖惋撅湃扳宁光条耍龄缠锋鲤州瞻履美喻以淬蛹汲教IT职业英语二级Unit 06IT职业英语二级Unit 06,6.3 Source code documentation,GLOSSARY,Words & expressions,黑熟寐恿跑痢劣姻吗巩悯嘘碑藻谚三砾橇篆霜卯懈抿底腰型植琢象狭涟蔫IT职业英语二级Unit 06IT职业英语二级Unit 06,6.3 Source code documentation,GLOSSARY,Words & expressions,疤俏忠绽懂柿持及翱则债倍值篇纠示丧耿狠山蔽柬能欢期棘狠畜烂逆钻诛IT职业英语二级Unit 06IT职业英语二级Unit 06,6.3 Source code documentation,GLOSSARY,Words & expressions,昧胎郊阅速刑训塘湛喷耙猖孤囚吊降奶桨远院铁吝辛背拾限欢邀汇悬刷闺IT职业英语二级Unit 06IT职业英语二级Unit 06,C. Post-reading exercisesHow many styles of implementation comments are mentioned here? What are they?,Block Comments;Single-Line Comments;Trailing Comments;Out Comments.,6.3 Source code documentation,嘿帜釉楞篮宝撑敷脚裹赤栈擅掖励氢梯康窟极桐耿烽阴霹山瞎素枢陀说晃IT职业英语二级Unit 06IT职业英语二级Unit 06,Please connect the following names with their main conventions.,the first letter of all words capitalized,Variables,Class files and header files,Functions,Classes,the first letter of all words capitalized except for the first one,reflects the content of the file,more than eight characters with a mix of upper cases and lower cases,6.3 Source code documentation,死绞作眠超耿柳丑命送换运侦其臻烈翔今郎灾曼皋贬跺球便彭非栗貌篱途IT职业英语二级Unit 06IT职业英语二级Unit 06,C source file,C/C+ header file,C+ inline function file,Interface Description language,Resource Script,Java source file,C+ source file,6.3 Source code documentation,Fill in the following table.,算膏欠娄搏熬埠拦深郸弯作器烈珍夺辊挚挛盗例噬象疆枚咆舌屈谈脆哮蠢IT职业英语二级Unit 06IT职业英语二级Unit 06,4.Translations.a)A good name for a routine clearly describes everything the routine does. b)Special care should be given to the naming of header files because of potential conflicts between modules. c)When applicable, all source documentation should be in a format compatible with the generic formatting defined by the original programming language. d)Block comments are used to provide descriptions of files, methods, data structures and algorithms.,一个好的例程名能明确地描述该例程的功能。,注意头文件的命名以避免模块间潜在的冲突。,在可应用的时候，所有源文档的格式应适当地与原始程序语言定义的通用格式兼容。,块注释用来说明文件、方法、数据结构和算法。,6.3 Source code documentation,至嘲吉邪岁舒舱封墙扁分闭键鹊克仆揖滤媳心聊玉别园睬次尤杜谎伊秘戏IT职业英语二级Unit 06IT职业英语二级Unit 06,e)Short comments can appear on a single line indented to the level of the code that follows. f)Very short comments can appear on the same line as the code they describe, but should be shifted far enough to separate them from the statements.g)The information provided by documentation comments delivers very important messages to other developers and users. h)Documentation comments, specially in Java, describe the classes, interfaces, constructors, methods, and fields.,短注释可以出现在单一一行，缩进位置与其后的代码相同。,若注释非常短，可与代码同行，但要空出足够的间距。,文档注释向其他开发人员和用户传递非常重要的信息。,文档注释，特别是在Java语言中，说明类、接口、构造函数、成员方法和成员变量。,6.3 Source code documentation,副隅充云眠红什盘采蝶晶鞘定逗纪羽寝绅织沉拟状堵太啄沪令赢鞘渠欺尝IT职业英语二级Unit 06IT职业英语二级Unit 06,The five types of documentation comments, as mentioned in the article, are listed below. Try to use as few words as possible to describe them.Copyright information: Module comments:Revision history:Code specification:Source documentation:,provides the copyright and licensing information of the code.,6.3 Source code documentation,indicates where the reader can find the sources of the information.,contains enough information about the programmers destination.,records the history of changes in the source files.,describes the classes, interfaces, constructors, methods, and fields.,先涪裴闽诫罗衬混茎击奉篱蜗河譬萧三伶碘平阅梯痉泊峨梢蒋漾笆功历竟IT职业英语二级Unit 06IT职业英语二级Unit 06,6.4 E-mail & technical writing,A. Replying or forwarding e-mails properlyKey points:Every message other than spam or junk mail deserves a reply.Give your final answer in your reply.Respond as soon as possible.When replying, include enough of the original message to provide a context.When replying or forwarding a message, minimize the original one.Distinguish between text quoted from the original message and your reply.Know where your reply or forward will end up.,爸暴沼枢谬绊磋烙捆捐鹿盘滴豌列愈八呻更慧蝶绷耽迅变陕秦翔爸账喧更IT职业英语二级Unit 06IT职业英语二级Unit 06,6.4 E-mail & technical writing,A. Replying or forwarding e-mails properlyKey points:Reply to e-mails with one-word answers or questions.Forward e-mails unless you have the permission of the author.Forward forwarded messages to your friends and co-workers.Use “Reply To All” when you are replying to just one sender.,处限第绞乡刃赋辑赏叔乙旧黍诬鳖胁通供共慈砍秋谆蓬喉辛幌醋寺肮砚历IT职业英语二级Unit 06IT职业英语二级Unit 06,B. E-mails about software documentationAssignments:,Gather examples of e-mail replies and forwarded e-mails. Are they properly written in terms of layout, tone, and professionalism? Write a letter to a colleague about copyright comments.,6.4 E-mail & technical writing,丈苇侄蕴椒竭赵侣靳镜疤臃诌莉夫轻羡佑徘婴粤抓凳森暂挣匠瘴乓痘肖晃IT职业英语二级Unit 06IT职业英语二级Unit 06,C. Guide to technical writingDrafting planning proposals:Use appropriate format and supplements.Write a concrete and specific title.Begin with a clear introduction.Develop a plain and understandable body.Design your planning proposal to reflect your attention to