Ramar är ganska svåra att förstå när en första använder dem: designen är mycket abstrakt, för att faktor ut allmängiltigheten designen är ofullständig, kräver ytterligare underklasser för att skapa en applikation designen ger exibilitet för flera hotspots, inte alla som behövs i ansökan till hands och samarbeten och de resulterande beroenden mellan klasser kan vara indirekta och dunkla. Många tillvägagångssätt för att dokumentera ramar har prövats, men med olika mål och målgrupper i åtanke. I detta dokument presenterar vi en uppgiftsorienterad ram för ramdokumentation. Vårt ramverk är baserat på att identifiera en uppsättning ram (åter)användningsfall, som sedan bryts ner i en uppsättning grundläggande tekniska uppgifter. Varje s u c h t a s k kräver en uppsättning dokumentation primitiva, så att vi kan ange en minimal uppsättning dokumentation primitiva för varje f r a m e w ork användningsscenario. Vi studerar några viktiga ramdokumentationsstrategier mot bakgrund av detta ramverk, kartlägger möjliga resultat och lyfter fram riktningar för ytterligare forskning. Tillstånd att göra digital/hård kopia av en del av eller hela detta verk för personligt eller klassrumsbruk beviljas utan avgift förutsatt att kopior inte görs eller distribueras för pro t eller kommersiell fördel, upphovsrättsmeddelandet, titeln på publikationen och dess datum visas, och meddelande ges om att kopiering är med tillstånd av ACM, Inc. Att kopiera på annat sätt, att publicera, att posta på servrar, eller att omfördela till listor, kräver föregående specific c tillstånd och / eller en avgift. Upphovsrätt 2000 ACM 00360-0300/00/0300es 2 G. Butler, R.K. Keller och H. Mili 1. INLEDNING Ramverk införs för att stödja utvecklingen av familjer av tillämpningar genom återanvändning Fayad och Schmidt 1997 Mili et al. 1995). Förstainstansrättens dom av den 15 juni 1995 i mål C-329/95, kommissionen mot Italien, REG 1995, s. Utformningen av ett ramverk de nes och xes vissa roller och ansvar bland klasserna, samt standardprotokoll för deras samarbete. Variabiliteten inom den familj av applikationer som finns till hands räknas in i så kallade \hotspots" Pree 1995], och ramen ger enkla mekanismer för att anpassa varje hotspot. Ett ramverk är inte lätt att förstå när en första använder det: designen är mycket abstrakt, för att faktor ut allmängiltigheten designen är ofullständig, kräver ytterligare underklasser för att skapa en applikation designen ger (för mycket) exibilitet, som inte alla kan behövas i ansökan till hands och samarbeten och resulterande beroenden mellan klasser kan vara indirekta och obskyra. Många tillvägagångssätt för att dokumentera ramar har prövats D enomm ee 1999 Campbell och Islam 1993], men med olika mål och publik i åtanke. Dessa olika målgrupper  på applikationsutvecklare, ramverksansvariga och ramutvecklare har ganska olika behov från dokumentation. I detta dokument föreslår vi en ram för att specificera den dokumentation som behövs för varje typ av ramanvändning, och vi studerar befintliga strategier för i vilken utsträckning de tillgodoser dessa behov. Vår strategi bygger på en analys av de olika ram (åter)använda fall, allt från enkla momentiation till fallet med gruvdrift ett ramverk för designidéer att använda i andra ramar. För varje s u c h (re-)use fall, identifierar vi en uppsättning elementära (programvara) tekniska uppgifter, var och en w i t h sina egna dokumentation behov sådana behov uttrycks i form av dokumentation primitiva. Denna inställning visas i figur 1 med OMT-notering.
Ett stort antal ramdokumentationstekniker finns REF.
A framework for framework documentation
{'venue': 'CSUR', 'journal': None, 'mag_field_of_study': ['Computer Science']}