IT职业英语二级Unit 06

UnitSixDocumentingYourWorkContentsPersuadingothers

Listening&speakingCommentingsourcecodesproperly

Technical

conversationsSourcecodedocumentationconventions

ReadingE-mail&technicalwriting

WritingObjectivesThisunitwillteachyou–

Toshowagreementanddisagreement; Tolearntopersuadeothers; Tocommentsourcecodesproperly; Toreadandwritesourcecodedocumentation; To

replyandforwarde-mails; Tolearnhowtodraftplanningproposals.6.1PersuadingothersA.Culturetips Listentotheaudioandanswerthesequestions:Whenyouwanttointerruptsomeone,thebesttimeis_____. A.inthemiddleofasentence B.afterhe/shefinisheshis/herspeech C.betweensentencesCWhichofthefollowingisthemosteffectivewaytoconveyyourmeaning?______

A.words B.intonation C.bodylanguageOccasionaldifferencesofopinionsbetweenabossandasubordinateareasignof________inAmericancompanies. A.agoodworkingrelationship B.anintenserelationship C.abadrelationship6.1PersuadingothersCAB.Groupdiscussions:persuadingothers1. Readthetwodialogsbetweenco-workersandtellwhichoneisbetter,theleftortheright.2. Listentotheconversation,theprojectteamisdiscussinghiringnewprogrammers.6.1Persuadingothers6.1PersuadingothersB.Groupdiscussions:persuadingothersSentencepatterns

LearntousetheseexpressionstoStronglyagree;Agree;Partlyagree;Disagree;Stronglydisagree;Interrupt.6.1PersuadingothersC.ExercisesDictation1.SomeTipsforPersuadingOthers1.

admittoaminorweakness2.

statingthestrengths

3.Icanbetrusted

4.actsagainsttheirownself-interest

5.buildcredibility

6.theopinionofothers

7.Forinstance

8.

ontheotherhand

9.

makingapositivestatement

10.

morecredible

11.

Themoresimilar

12.

themorepowerful

13.

makeinformeddecisions

6.1PersuadingothersC.ExercisesDictation2.Conversationbetweencolleagues1.

efficientandreliable

2.

Ifeelsure

3.

Iagreewithyou

4.

ontheotherhand

5.

asksfor6.

chargesfarless

7.

you’vegotapoint

8.

accordingto6.1PersuadingothersOralpracticeYOUMr.JohnsonShowyourunderstanding.Idon’tthinkwecanmoveintotheJapanesemarketatthistime.We’dbetterimproveandincreaseourshareofthemarkethereinChina.Trytointerrupt.ThepotentialmarketinJapanisnodoubthuge,but…Showagreement.JustletmefinishwhatIwassaying,please.Showyourunderstanding.…but,beforewemoveintotheJapanesemarketweshouldstrengthenourmarketsharehereinChina.Whatwereyoutryingtosayjustnow?IbelieveoursuccessinChinacanbringusamuchmorereliablereputationthanjustsettingupbranchesinJapan.Whatdoyouthink?Doyouagreewithme?Iwastryingtoremindyouthatourrival,AAACompany,hasalreadysetupseveralbranchesinJapan.Ithasalreadybeguntoestablishitsreputationthere.Completelydisagree,insistonmovingintoJapanesemarketnow.

A.DiscussingcodedocumentingconventionsAnnieJefferson,SamCarter,andMichaelZhangarereceivingatrainingprogramofferedbytheR&DDepartment. that’saboutall… jotdown…Languagepoints: make…clear stickto getreadyforTechnicalterms: codedocumentation

6.2Commentingsourcecodes…

B.RefiningsubstandardsourcecodesJackyisassemblingagroupdiscussionwithSamandAnnieabouttheircodecomments. getdowntobusiness I’msorrytosay…Languagepoints: breakoldhabits thereisaproblemwith… itwouldbemuchbetterif…Technicalterms: sourcedocumentation

6.2Commentingsourcecodes…C.Fillintheblanks

1.Fillintheblanksinthefollowingsentenceswiththegivenexpressions.a) –Iguessanewyearisagoodtimefor__________________. Weshouldstarttomakethenewdevelopmentregulations workfromnowon. –Thatsoundsgreat,butareyousureyourguyshave_____ theregulations______enoughtoputintoeffect?b) –____________________thesyntaxintheselines.Have youcheckedthecodeyourself? –Ah,Iamterriblysorry,pleaseletme_________these lines,andI’llgetaroundtothemassoonaspossible.breakingoldhabitsmadeclearThereisaproblemwithjotdown6.2Commentingsourcecodes…c) –Well,Iassume_______________________classnames, variables,andcommentswereinboldorinadifferentcolor. –Thanksforyouradvice,butI’dbetter_______the conventionssetbymycompany.d) –OK,everyone._______________forthissessionofour meeting.Inthenextsession,we’llhavegroupdiscussions aboutwhatwe’velearnttoday. –______________thatIamstillconfusedaboutonething: whycan’twecapitalizethefirstwordinafunctionname?e) –Thegoodnewsis,withthenewplatform,programmerswill ___________________fasterwithhundredsofcompatible productsandintegratedsolutions. –Maybe,theyjusthavetospendalotoftimeto ____________thisnewchange.itwouldbemuchbetterifsticktoThat’saboutallI’msorrytosaygetreadyforgetdowntobusiness6.2Commentingsourcecodes…a) Youareconcludingapresentationaboutyourworkinthepreviousmonth. ________________________________________________________________________________________________________b) Acolleagueaskedwhattoincludeinthecopyrightcomment.Youarenotverysure.________________________________________________________________________________________________________Sothat’saboutalloftheprogressreportformyworkoverthelastmonth.I’mafraidI’mnotreallysureaboutthecontentinthecopyrightcomment.

6.2Commentingsourcecodes…C.Fillintheblanks

1.Supposeyouareinthefollowingsituations.Whatshouldyousay?

c) Yourgrouphasalotofcontroversyaboutanunsettledissue.Yousuggestdiscussingitlater. ___________________________________________________d) Acolleaguepointedoutthatyoualwaysstartanewlineforthecomments.Youdon’tunderstandwhat’swrongwiththat.

___________________________________________________

e) Youareremindingalltheteammemberstocitesourcesforalltheborrowedcodes. ___________________________________________________ ___________________________________________________

Let’sjustputitasidefornow.Isthereaproblemwiththat?Youmustremembertodocumentthesourcealongwiththecodeyouborrow.6.2Commentingsourcecodes…D.Workinpairs Imagineyouandyourpartnerareinagroupdiscussion.Sittogether,andmakeupconversationsaccordingtothefollowinginformation.Taketurnsplayingdifferentroles.6.2Commentingsourcecodes…E.Groupwork

1.Formgroupsofthreetofourpeople,andholdagroupdiscussionaccordingtothefollowinginformation.Changetheroleswhenyou’vedonewithoneversion.Remembertovaryyourlanguagewithyourcreativity.6.2Commentingsourcecodes… 2.Formagroupwithothermembersofyourclass.Locateapieceofsourcecodedevelopedbyanyoneofyou,andinitiateagroupdiscussionabouthowtomakeitmorereadableandstandard.Moreimportantly,trytoadaptthecodewiththemethodsyouagreedon.6.2Commentingsourcecodes…A.Anoverview

Readtheoverviewandanswerthesequestions:Whatissoftwaredocumentationusedfor?Whoisresponsibleforcreatingsoftwaredocumentation?Howissoftwaredocumentationcreated?6.3Sourcecodedocumentation…B.Anamingandcodedocumentationguide Beforeyouscanthewholedocument,keepthesequestionsinmind:Whatisthisdocumentmainlytalkingabout?Whereshallwegoifwewanttoknowaboutimplementationcomments?Whenshouldweuseblockcommentsincodedocumentation?Howmanytypesofdocumentationcommentsareincludedinthisarticle?6.3Sourcecodedocumentation…6.3Sourcecodedocumentation…convention

n.

约定，规范function

n.

函数trailing

adj.

拖尾的ruleofthumb

经验法则potential

adj.

可能的，潜在的prefix

n.

前缀illustrate

vt.

说明，阐明concatenate

vt.

连接，并置routine

n.

例程，例行程序procedure

n.

过程，程序GLOSSARYWords&expressions6.3Sourcecodedocumentation…cohesion

n.

内聚度imply

vt.

暗示，意味precisely

iii

adv.

精确地，明确地wishy-washy

iii

adj.

乏味的elastic

ii

adj.

灵活的stretch

vt.

延伸，扩展generic

adj.

一般的，通用的overwhelm

vt.

淹没，压倒delimit

vt.

定界限，限定perspective

n.

观点，看法GLOSSARYWords&expressions6.3Sourcecodedocumentation…readily

adv.

容易地non-trivial

adj.

重要的duplicate

vt.

复制，重复redundant

adj.

冗余的evolve

vi.

发展asterisk

n.

星号，星标indent

vt.

缩进precede

vt.

先于，在…之前apart

adv.

分开，离开differ

vi.

相异，不同GLOSSARYWords&expressions6.3Sourcecodedocumentation…shift

vt.

移位chunk

n.

块，程序块delimiter

n.

定界符,分隔符consecutive

adj.

连续的adequate

adj.

适当的，足够的destination

n.

目的，目标deliberate

adj.

谨慎的align

vt.

校直，使对齐GLOSSARYWords&expressionsC.Post-readingexercisesHowmanystylesofimplementationcommentsarementionedhere?Whatarethey?BlockComments;Single-LineComments;TrailingComments;OutComments.6.3Sourcecodedocumentation…Pleaseconnectthefollowingnameswiththeirmainconventions.thefirstletterofallwordscapitalizedVariablesClassfilesandheaderfilesFunctionsClassesthefirstletterofallwordscapitalizedexceptforthefirstonereflectsthecontentofthefilemorethaneightcharacterswithamixofuppercasesandlowercases6.3Sourcecodedocumentation…ExtensionDescription.C.CPP.H.INL.IDL(.ODL).RC.JavaCsourcefileC/C++headerfileC++inlinefunctionfileInterfaceDescriptionlanguageResourceScriptJavasourcefileC++sourcefile6.3Sourcecodedocumentation…Fillinthefollowingtable.4. Translations.a) Agoodnameforaroutineclearlydescribeseverythingtheroutinedoes.

b) Specialcareshouldbegiventothenamingofheaderfilesbecauseofpotentialconflictsbetweenmodules.

c) Whenapplicable,allsourcedocumentationshouldbeinaformatcompatiblewiththegenericformattingdefinedbytheoriginalprogramminglanguage.

d) Blockcommentsareusedtoprovidedescriptionsoffiles,methods,datastructuresandalgorithms.

一个好的例程名能明确地描述该例程的功能。

注意头文件的命名以避免模块间潜在的冲突。在可应用的时候，所有源文档的格式应适当地与原始程序语言定义的通用格式兼容。块注释用来说明文件、方法、数据结构和算法。

6.3Sourcecodedocumentation…e) Shortcommentscanappearonasinglelineindentedtothelevelofthecodethatfollows.

f) Veryshortcommentscanappearonthesamelineasthecodetheydescribe,butshouldbeshiftedfarenoughtoseparatethemfromthestatements.g) Theinformationprovidedbydocumentationcommentsdeliversveryimportantmessagestootherdevelopersandusers.h) Documentationcomments,speciallyinJava,describetheclasses,interfaces,constructors,methods,andfields.

短注释可以出现在单一一行，缩进位置与其后的代码相同。若注释非常短，可与代码同行，但要空出足够的间距。

文档注释向其他开发人员和用户传递非常重要的信息。文档注释，特别是在Java语言中，说明类、接口、构造函数、成员方法和成员变量。6.3Sourcecodedocumentation…Thefivetypesofdocumentationcomments,asmentionedinthearticle,arelistedbelow.Trytouseasfewwordsaspossibletodescribethem.Copyrightinformation:

Modulecomments:Revisionhistory:Codespecification:Sourcedocumentation:providesthecopyrightandlicensinginformationofthecode.6.3Sourcecodedocumentation…indicateswherethereadercanfindthesourcesoftheinformation.containsenoughinformationabouttheprogrammer’sdestination.recordsthehistoryofchangesinthesourcefiles.describestheclasses,interfaces,constructors,methods,andfields.6.4E-mail&technicalwritingA.Replyingorforwardinge-mailsproperly

Keypoints:Everymessageotherthanspamorjunkmaildeservesareply.Giveyourfinalanswerinyourreply.Respondassoonaspossible.Whenreplying,includeenoughoftheoriginalmessagetoprovideacontext.Whenreplyingorforwardingamessage,minimizetheoriginalone.Distinguishbetweentextquotedfromtheoriginalmessageandyourreply.Knowwhereyourreplyorforwardwillendup.6.4E-mail&technicalwritingA.Replyingorforwardinge-mailsproperly Keypoints:Replytoe-mailswithone-wordanswersorquestions.Forwarde-mailsunlessyouhavethepermissionoftheauthor.Forwardforwardedmessagestoyourfriendsandco-workers.Use“ReplyToAll”whenyouarereplyingtojustonesender.B.E-mailsaboutsoftwaredocumentation

Assignments:Gatherexamplesofe-mailrepliesandforwardede-mails.Aretheyproperlywrittenintermsoflayout,tone,andprofessionalism?Writealettertoacolleagueaboutcopyrightcomments.6.4E-mail&technical