資源描述：
《Documenting_Software_Architecture英文文獻(xiàn)資料》由會(huì)員上傳分享，免費(fèi)在線閱讀，更多相關(guān)內(nèi)容在行業(yè)資料-天天文庫。
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
