资源描述：
《Documenting_Software_Architecture英文文献资料》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。
1、DRAFTCOPYFORREVIEW:DONOTCOPYWITHOUTPERMISSIONCOPYRIGHT2001,2002ADDISONWESLEYALLRIGHTSRESERVEDDocumentingSoftwareArchitecturesPaulClementsFelixBachmannLenBassDavidGarlanJamesIversReedLittleRobertNordJudyStafford1November2001--SecondReviewEdition(7-3/8”x9-1/4”)DocumentingSoftwareArchitecturesClement
2、s,Bachmann,Bass,Garlan,Ivers,LIttle,Nord,StaffordNotetoReviewersThismanuscriptisfairlycomplete,butitisstillaworkinprogress.Inparticular:•Weplantoincludethreerunningexampleapplicationsthroughoutthebook.Theexamplesarealargewar-gamingsimulationsystem,asatellitedatacollectionanddistributionsystem,anda
3、smallJavaapplicationfortelephony.Currently,theworkispopulatedwithsmallerdisjointexamplesthatillustratekeypointsinplace.Thethreerunningexampleswillforthemostpartcomplement,notreplace,thesmallerexamplesasawaytolendcontinuitytothework.•Severalsectionsandsidebarshave“tbd”marks,indicatingareasthatneedc
4、ompletion.•Wewillhaveallofthefiguresandillustrationsre-drawn.•Weneedtohandleanumberofdetails,suchasnailingdowninternalcross-references,externalcitations,discussionquestions,glossaries,andadvicechecklists.Wealsoaskyoutotakealeapofvisualfaith.Ourtextincludesmanycallouts,whicharedescribedintheRead-er
5、’sGuide.Wewantthebooktohaveadistinctivevisualstyle,andthecalloutsareadornedwithvisualiconsdenotingtheircontent.However,thecalloutsinthismanuscriptarepoor,temporaryattemptsbyamateurs.Thesewillbesupplantedbyaprofessionaltreatmentgivenbypeoplewhoknowwhatthey’redoing.Weaskyoutouseyourimaginationtoseet
6、hesecalloutsastheymightappearinthefinalwork.Also,inthefinalwork,thesidebarswillreallybeofftotheside,sothatareadercanmoreeasilyskipthemorreadthemathisorherleisure.Asyoureadthismanuscript,pleasekeepthefollowingquestionsinmind:1.Clarity:Afteryoureadthisbook,wouldyoubeabletoproduceasoftwarearchitectur
7、edocumentationpackagefromit?Ifnot,whatsectionslackthenecessaryclarityorprescriptivedetail?2.Rightprescription:Iswhatwehaveprescribedwithinreason?Whichpartsofwhatweprescribewouldyoujettisonandwhy?Whatpartsofasoftw
