IT职业英语二级软件类课后答案Unit .ppt

UnitSixDocumentingYourWork Contents PersuadingothersListening speakingCommentingsourcecodesproperlyTechnicalconversationsSourcecodedocumentationconventionsReadingE mail technicalwritingWriting Objectives Thisunitwillteachyou Toshowagreementanddisagreement Tolearntopersuadeothers Tocommentsourcecodesproperly Toreadandwritesourcecodedocumentation Toreplyandforwarde mails Tolearnhowtodraftplanningproposals 6 1Persuadingothers A CulturetipsListentotheaudioandanswerthesequestions Whenyouwanttointerruptsomeone thebesttimeis A inthemiddleofasentenceB afterhe shefinisheshis herspeechC betweensentences C Whichofthefollowingisthemosteffectivewaytoconveyyourmeaning A wordsB intonationC bodylanguageOccasionaldifferencesofopinionsbetweenabossandasubordinateareasignof inAmericancompanies A agoodworkingrelationshipB anintenserelationshipC abadrelationship 6 1Persuadingothers C A B Groupdiscussions persuadingothers1 Readthetwodialogsbetweenco workersandtellwhichoneisbetter theleftortheright 2 Listentotheconversation theprojectteamisdiscussinghiringnewprogrammers 6 1Persuadingothers 6 1Persuadingothers B Groupdiscussions persuadingothersSentencepatternsLearntousetheseexpressionstoStronglyagree Agree Partlyagree Disagree Stronglydisagree Interrupt 6 1Persuadingothers C ExercisesDictation1 SomeTipsforPersuadingOthers 1 admittoaminorweakness2 statingthestrengths3 Icanbetrusted4 actsagainsttheirownself interest5 buildcredibility6 theopinionofothers7 Forinstance 8 ontheotherhand9 makingapositivestatement10 morecredible11 Themoresimilar12 themorepowerful13 makeinformeddecisions 6 1Persuadingothers C ExercisesDictation2 Conversationbetweencolleagues 1 efficientandreliable2 Ifeelsure3 Iagreewithyou4 ontheotherhand 5 asksfor6 chargesfarless7 you vegotapoint8 accordingto 6 1Persuadingothers Oralpractice YOU Mr Johnson Showyourunderstanding 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 clearsticktogetreadyforTechnicalterms codedocumentation 6 2Commentingsourcecodes B RefiningsubstandardsourcecodesJackyisassemblingagroupdiscussionwithSamandAnnieabouttheircodecomments getdowntobusinessI msorrytosay Languagepoints breakoldhabitsthereisaproblemwith itwouldbemuchbetterif Technicalterms sourcedocumentation 6 2Commentingsourcecodes C Fillintheblanks1 Fillintheblanksinthefollowingsentenceswiththegivenexpressions a Iguessanewyearisagoodtimefor Weshouldstarttomakethenewdevelopmentregulationsworkfromnowon Thatsoundsgreat butareyousureyourguyshave theregulations enoughtoputintoeffect b thesyntaxintheselines Haveyoucheckedthecodeyourself Ah Iamterriblysorry pleaseletme theselines andI llgetaroundtothemassoonaspossible breakingoldhabits made clear Thereisaproblemwith jotdown 6 2Commentingsourcecodes c Well Iassume classnames variables andcommentswereinboldorinadifferentcolor Thanksforyouradvice butI dbetter theconventionssetbymycompany d OK everyone forthissessionofourmeeting Inthenextsession we llhavegroupdiscussionsaboutwhatwe velearnttoday thatIamstillconfusedaboutonething whycan twecapitalizethefirstwordinafunctionname e Thegoodnewsis withthenewplatform programmerswill fasterwithhundredsofcompatibleproductsandintegratedsolutions Maybe theyjusthavetospendalotoftimeto thisnewchange itwouldbemuchbetterif stickto That saboutall I msorrytosay getreadyfor getdowntobusiness 6 2Commentingsourcecodes a Youareconcludingapresentationaboutyourworkinthepreviousmonth b Acolleagueaskedwhattoincludeinthecopyrightcomment Youarenotverysure Sothat saboutalloftheprogressreportformyworkoverthelastmonth I mafraidI mnotreallysureaboutthecontentinthecopyrightcomment 6 2Commentingsourcecodes C Fillintheblanks1 Supposeyouareinthefollowingsituations Whatshouldyousay c Yourgrouphasalotofcontroversyaboutanunsettledissue Yousuggestdiscussingitlater d Acolleaguepointedoutthatyoualwaysstartanewlineforthecomments Youdon tunderstandwhat swrongwiththat e Youareremindingalltheteammemberstocitesourcesforalltheborrowedcodes Let sjustputitasidefornow Isthereaproblemwiththat Youmustremembertodocumentthesourcealongwiththecodeyouborrow 6 2Commentingsourcecodes D WorkinpairsImagineyouandyourpartnerareinagroupdiscussion Sittogether andmakeupconversationsaccordingtothefollowinginformation Taketurnsplayingdifferentroles 6 2Commentingsourcecodes E Groupwork1 Formgroupsofthreetofourpeople andholdagroupdiscussionaccordingtothefollowinginformation Changetheroleswhenyou vedonewithoneversion Remembertovaryyourlanguagewithyourcreativity 6 2Commentingsourcecodes 2 Formagroupwithothermembersofyourclass Locateapieceofsourcecodedevelopedbyanyoneofyou andinitiateagroupdiscussionabouthowtomakeitmorereadableandstandard Moreimportantly trytoadaptthecodewiththemethodsyouagreedon 6 2Commentingsourcecodes ExampleofComments ExampleofComments cont A AnoverviewReadtheoverviewandanswerthesequestions Whatissoftwaredocumentationusedfor Whoisresponsibleforcreatingsoftwaredocumentation Howissoftwaredocumentationcreated 6 3Sourcecodedocumentation B AnamingandcodedocumentationguideBeforeyouscanthewholedocument keepthesequestionsinmind Whatisthisdocumentmainlytalkingabout Whereshallwegoifwewanttoknowaboutimplementationcomments Whenshouldweuseblockcommentsincodedocumentation Howmanytypesofdocumentationcommentsareincludedinthisarticle 6 3Sourcecodedocumentation 6 3Sourcecodedocumentation GLOSSARY Words expressions 6 3Sourcecodedocumentation GLOSSARY Words expressions 6 3Sourcecodedocumentation GLOSSARY Words expressions 6 3Sourcecodedocumentation GLOSSARY Words expressions C Post readingexercisesHowmanystylesofimplementationcommentsarementionedhere Whatarethey BlockComments Single LineComments TrailingComments OutComments 6 3Sourcecodedocumentation Pleaseconnectthefollowingnameswiththeirmainconventions thefirstletterofallwordscapitalized Variables Classfilesandheaderfiles Functions Classes thefirstletterofallwordscapitalizedexceptforthefirstone reflectsthecontentofthefile morethaneightcharacterswithamixofuppercasesandlowercases 6 3Sourcecodedocumentation Csourcefile C C headerfile C inlinefunctionfile InterfaceDescriptionlanguage ResourceScript Javasourcefile C sourcefile 6 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 technicalwriting A Replyingorforwardinge mailsproperlyKeypoints Everymessageotherthanspamorjunkmaildeservesareply Giveyourfinalanswerinyourreply Respondassoonaspossible Whenreplying includeenoughoftheoriginalmessagetoprovideacontext Whenreplyingorforwardingamessage minimizetheoriginalone Distinguishbetweentextquotedfromtheoriginalmessageandyourreply Knowwhereyourreplyorforwardwillendup 6 4E mail technicalwriting A Replyingorforwardinge mailsproperlyKeypoints Replytoe mailswithone wordanswersorquestions Forwarde mailsunlessyouhavethepermissionoftheauthor Forwardforwardedmessagestoyourfriendsandco workers Use ReplyToAll whenyouarereplyingtojustonesender B E mailsaboutsoftwaredocumentationAssignments Gatherexamplesofe mailrepliesandforwardede mails Aretheyproperlywrittenintermsoflayout tone andprofessionalism Writealettertoacolleagueaboutcopyrightcomments 6 4E mail technicalwriting C GuidetotechnicalwritingDraftingplanningproposals Useappropriateformatandsupplements Writeaconcreteandspecifictitle B