1、STD-DIN DIN bb270-GERM 1998 m 279444b ObL422 717 I I Fortsetzung Seite 2 bis 4 Normenausschu Informationstechnik (NI) im DIN Deutsches Institut fr Normung e.V. DEUTSCHE NORM Januar 1998 I I I Informationstechnik Bewerten von Softwaredokumenten Qualittsmerkmaie DIN - 66270 I I ICs 35.080 Deskriptoren
2、: Informationstechnik, Software, Qualittsmerkmal, Dokument Information technology - Software document evaluation - Quality characteristics Technologies de l?information - valuation des documents de logiciels - Caractristiques de qualit Vorwort Softwaredokurnente enthalten Informationen ber Software.
3、 Solche Informationen werden fr die Anforderung, Entwicklung und Nutzung von Software bentigt. Aus diesen unterschiedlichen Verwendungen ergeben sich unter- schiedliche Anforderungen an die Informationen und damit an die Dokumente. Aussagen ber die Qualitt der Dokumente geben Auskunft darber, wie gu
4、t die jeweiligen Anforderungen erfllt werden. Zur Qualitt von Dokumenten tragen verschiedene ihrer Eigenschaften bei. Als Voraussetzung seiner Verwendung rnu ein Dokument anhand einer Kennzeichnung identifizierbar sein. Mageblich fr die Verwendung selbst ist sein Inhalt. Er soll vollstndig, angemess
5、en, fehlerfrei und konsistent sein. Der Inhalt It sich aus einem Dokument aber nur dann wiedergewinnen, wenn seine Darstellung dies zult. Er mu deshalb verstndlich und bersichtlich dargestellt sein. Schlielich kann ein Dokument nur verwendet werden, wenn sein physischer Zustand dies zult. Die Qualit
6、t eines Dokumentes mu daher unter den Aspekten der Kennzeichnungs-, der Inhalts-, der Darstellungs- und der Aus- fhrungsqualitt betrachtet werden. Die Beurteilung des Inhaltes hngt unter anderem von der Art des jeweiligen Dokumentes ab. Dabei ist zwischen spezi- fizierenden und beschreibenden Dokume
7、nten zu unterscheiden: a) Ein Produkt als Gegenstand einer Spezifikation oder ein Vorgang als Gegenstand eines Planes existieren wh- rend der Gltigkeit dieser Dokumente nur in diesen Dokumenten. Umgekehrt haben diese Dokumente nur den Zweck, eben diese Gegenstnde festzulegen. Die Beurteilung der Eig
8、nung solcher spezifizierenden Dokumente mu also die Beurteilung dieser Gegenstnde, etwa die ihrer Angemessenheit und Konsistenz, einschlieen. b) Der Inhalt eines beschreibenden Dokumentes, etwa eines Protokolls oder einer Benutzungsanleitung, hat dagegen einen auerhalb des Dokumentes vorhandenen Geg
9、enstand wiederzugeben, in diesen Beispielen eine Diskussion oder die Anwendung eines Produktes. Die Qualitt des Inhalts liegt deshalb in der Wiedergabe dieses Gegenstandes, nicht in der Qualitt des Gegenstandes selbst. Die Qualitt eines Protokolls einer Diskussion, die zu einem fehlerhaften Ergebnis
10、 fhrte, ist hoch, wenn es diese Diskussion zutreffend wiedergibt. Sie wird durch das fehlerhafte Ergebnis der Diskussion nicht gemindert. Angemessenheit und Konsistenz sind daher fr beschrei- bende Dokumente keine Kriterien. 1 Anwendungsbereich Diese Norm legt die Merkmale fr die Qualitt von Soft- w
11、aredokumenten fest. Sie kann auf alle Arten von Software- dokumenten angewandt werden, namentlich auf Entwick- lungs- und Benutzerdokumente. Ihr Zweck ist es, fr die Beschreibung der Qualitt von Sotwaredokumenten Merk- male bereitzustellen, fr die bei der Formulierung von Qualittsanforderungen oder
12、-aussagen Werte festgelegt werden knnen. Sie gestattet durch die merkrnalsorientierte Beschreibung von Dokumenten detaillierte und vergleich- bare Angaben ber den Zustand dieser Dokumente. ANMERKUNG: Diese Norm ergnzt DIN 66272 : 1994-10, die fr Softwareprodukte gilt, um den Bereich der Softwaredoku
13、mente. 2 Normative Verweisungen Diese Norm enthlt durch datierte oder undatierte Verwei- sungen Festlegungen aus anderen Publikationen. Diese normativen Verweisungen sind an den jeweiligen Stellen im Text zitiert, und die Publikationen sind nachstehend aufgefhrt. Bei datierten Verweisungen gehren sp
14、tere Anderungen oder Uberarbeitungen dieser Publikationen nur zu dieser Norm, falls sie durch Anderung oder Uberar- beitung eingearbeitet sind. Bei undatierten Verweisungen gilt die letzte Ausgabe der in Bezug genommenen Publi- kation. DIN 6789-1 : 1990-09 Dokumentationssystematik - Aufbau Technisch
15、er Produktdokumentation Seite 2 DIN 66270 : 1998-01 DIN 66272 : 1994-10 Informationstechnik - Bewerten von Softwareproduk- ten - Qualittsmerkmale und Leitfaden zu ihrer Ver- wendung: Identisch mit ISOAEC 9126 : 1991 Informationsverarbeitung - Begriffe - Allgemeine Begriffe Begriffe der Qualittssiche
16、rung und Statistik - Merk- malsbezogene Begriffe Qualittsmanagement - Begriffe (IS0 8402 : 1994); Dreisprachige Fassung EN IS0 8402 : 1995 DIN 44300-1 : 1988-11 DIN 55350-12 : 1989-03 DIN EN IS0 8402 : 1995-08 3 Definitionen Fr die Anwendung dieser Norm gelten die folgenden Definitonen: 3.1 Dokument
17、 Ein Dokument ist eine als Einheit gehandhabte Zusam- menfassung oder Zusammenstellung von Informationen, die nicht-flchtig auf einem Informationstrger gespei- chert sind. DIN 6789-1 : 1990-091 ANMERKUNG 1: In dieser Norm wird eine spezifi- sche Darstellung dieser Informationen (z. B. in ver- baler
18、Form) jeweils als ein Dokument betrachtet. Eine andere Darstellung der gleichen Informatio- nen (z.B. in bildhafter Form) erzeugt somit ein anderes Dokument. ANMERKUNG 2: Ein Dokument kann in mehreren Exemplaren vorliegen. Die Exemplare knnen sich in den Werten mehrerer Merkmale, z.B. in der Sprache
19、 und im Typ des Informationstrgers, unterscheiden. 3.2 Gegenstand Objekt, auf das sich die in einem Dokument enthaltenen Informationen beziehen; z. B. kann Gegenstand einer Spezifikation ein Produkt, Gegenstand eines Protokolls eine Diskussion sein. 3.3 Merkmal Eigenschaft zum Erkennen oder zum Unte
20、rscheiden von Einheiten. DIN 55350-12 : 1989-031 3.4 Qualitt Gesamtheit von Merkmalen (und Merkmalswerten) einer Einheit bezglich ihrer Eignung, festgelegte und voraus- gesetzte Erfordernisse zu erfllen. DIN EN IS0 8402 : 1995-081 3.5 Software Gesamtheit oder Teil der Programme fr Rechensysteme, wob
21、ei die Programme zusammen mit den Eigenschaften der Rechensysteme - den Betrieb der Rechensysteme, - die Nutzung der Rechensysteme zur ;Lsung gestellter Aufgaben oder - zustzliche Betriebs- oder Anwendungsarten der Rechensysteme ermglichen. DIN 44300-1 : 1988-111 ANMERKUNG 1 : Zugehrige Dokumentatio
22、n kann als Bestandteil der Software angesehen werden. DIN 44300-1 : 1988-111 ANMERKUNG 2: Im Sinne dieser Norm ist ein Softwaredokument demnach ein Dokument, des- sen Gegenstand die Herstellung, Pflege oder Anwendung von Software oder deren Ergebnisse sind. 4 Qualittsmerkmale 4.1 Qualitt der Kennzei
23、chnung Die Gesamtheit der Merkmale und Merkmalswerte eines Dokumentes, die sich auswirken auf die Erkennbarkeit der Identitt und des Standes dieses Dokumentes und gegebenenfalls organisationsspezifisch festgelegter Informationen ber das Dokument. ANMERKUNG: Organisationsspezifisch festge- legte Info
24、rmationen ber das Dokument knnen z.B. Angaben zur Vertraulichkeit, zum Autor und zum Ausgabedatum sein. 4.2 Qualitt des Inhalts Die Gesamtheit der Merkmale und Merkmalswerte eines Dokumentes, die sich auswirken auf die Eignung der in dem Dokument enthaltenen Informationen zur Erfllung des fr den bes
25、chriebenen Gegenstand festgelegten Ver- wendungszweckes. ANMERKUNG: Die Inhaltsqualitt eines Exem- plars eines Dokumentes kann durch Fehler bei der Herstellung des Exemplars (z. B. bei einer Uberset- zung oder einer technischen bertragung) beein- trchtigt werden. 4.2.1 Vollstndigkeit Die Gesamtheit
26、der Merkmale und Merkmalswerte eines Dokumentes, die sich auswirken auf Umfang und Detail- lierungsgrad der in diesem Dokument enthaltenen Infor- mationen. ANMERKUNG: Umfang und Detaillierungsgrad dienen der Erfllung des Verwendungszweckes dieses Dokumentes und knnen von einer festge- legten Zielgru
27、ppe abhngen. 4.2.2 Angemessenheit Die Gesamtheit der Merkmale und Merkmalswerte der in einem Dokument vorgesehenen oder festgelegten techni- schen, organisatorischen oder wirtschaftlichen Mittel, die sich auswirken auf die Eignung des dokumentierten Gegenstandes, einen fr ihn festgelegten Verwendung
28、s- Zweck zu erfllen. ANMERKUNG: Das Merkmal Angemessenheit ist nur auf Planungs- und Spezifikationsdokumente anwendbar, deren Gegenstand nur durch diese Dokumente festgelegt ist. 4.2.3 Fehlerfreiheit Die Gesamtheit der Merkmale und Merkmalswerte der in einem Dokument enthaltenen Informationen, die s
29、ich auswirken auf die Freiheit von Widersprchen dieser Informationen zu wahren oder als wahr angenommenen Sachverhalten. 4.2.4 Konsistenz Die Gesamtheit der Merkmale und Merkmalswerte der in einem Dokument enthaltenen Informationen, die sich aus- wirken auf die Freiheit von Widersprchen dieser Infor
30、- mationen und ihrer Voraussetzungen und Folgen in sich selbst und zu Informationen anderer Dokumente zum gleichen Gegenstand und deren Voraussetzungen und Folgen. STDmDIN DIN bb270-GERM 2998 277LiLiLib Ob8LLi24 59T 9 ANMERKUNG: Das Merkmal Konsistenz ist nur auf Planungs- und Spezifikationsdokument
31、e anwendbar, deren Gegenstand nur durch diese Dokumente festgelegt ist. 4.3 Qualitt der Darstellung Die Gesamtheit der Merkmale und Merkmalswerte der Gestaltung und Darstellung der in einem Dokument ent- haltenen Informationen, die sich auswirken auf dessen Eignung zur Wiedergewinnung dieser Informa
32、tionen. ANMERKUNG: Die Darstellungsqualitt eines Exemplars eines Dokumentes kann durch Fehler bei der Herstellung des Exemplars (2: B. bei einer Ubersetzung oder einer technischen Ubertragung) beeintrchtigt werden. 4.3.1 Verstndlichkeit Die Gesamtheit der Merkmale und Merkmalswerte der Darstellung d
33、er in einem Dokument enthaltenen Informa- tionen, die es einer festgelegten Zielgruppe ermglichen, diese Informationen unverndert wiederzugewinnen. 4.3.2 bersichtlichkeit Die Gesamtheit der Merkmale und Merkmalswerte der Darstellung der in einem Dokument enthaltenen Informa- tionen, die es einer fes
34、tgelegten Zielgruppe ermglichen, sich einen Uberblick ber Inhalt und Struktur der in dem Dokument enthaltenen Informationen und ber das Infor- mationsumfeld zu verschaffen und auf einzelne Details zuzugreifen. ANMERKUNG: Das Merkmal bersichtlichkeit kann sich auswirken auf die nderbarkeit des Dokume
35、ntes. 4.4 Qualitt der physischen Ausfhrung Die Gesamtheit der Merkmale und Merkmalswerte eines Exemplars eines Dokumentes, die sich auswirken auf dessen Eignung zur Wiedergewinnung der in der ihm ent- haltenen Daten. Seite 3 DIN 66270 1998-01 4.4.1 Deutlichkeit Die Gesamtheit der Merkmale und Merkrn
36、alswerte eines Exemplars eines Dokumentes, die sich auswirken auf die Erkennbarkeit der darin enthaltenen Daten durch einen Menschen oder durch eine Maschine. 4.4.2 Beanspruchbarkeit Die Gesamtheit der Merkmale und Merkmalswerte eines Exemplars eines Dokumentes, die sich auswirken knnen auf eine mgl
37、iche Verschlechterung der Merkmalswerte der Qualitt dieses Dokumentes bei Beanspruchung durch Nutzung und Umwelt. 4.4.3 Handhabbarkeit Die Gesamtheit der Merkmale und Merkmalswerte eines Exemplars eines Dokumentes, die sich auf den Aufwand auswirken, der fr die Handhabung dieses Dokumentes erforderl
38、ich ist. ANMERKUNG: Aufwand kann z. B. beim Transport, bei der Lagerung oder bei der Bereitstellung einer fr die Handhabung erforderlichen Apparatur ent- stehen. 4.4.4 nderungsverhalten Die Gesamtheit der Merkmale.und Merkmalswerte eines Dokumentes, die sich auf die Anderbarkeit dieses Doku- mentes
39、auswirken und darauf, durchgefhrte Anderungen erkennen zu lassen. 4.5 Regelkonformitt Die Gesamtheit der Merkmale und Merkmalswerte eines Dokumentes oder eines Exemplars eines Dokumentes, die sich auswirken auf die Konformitt dieses Dokumen- tes oder dieses Exemplars zu festgelegten Regeln. ANMERKUN
40、G: Die Regeln knnen sich auf den Inhalt, die Darstellung oder die physische Ausfh- rung eines Dokumentes beziehen. STD-DIN DIN bb270-GERM 1998 277444b 0b81425 42b Seite 4 DIN 66270 : 1998-01 Anhang A (informativ) Bewerten der Dokumentenqualitt Zum Bewerten der Qualitt eines Dokumentes oder eines sei
41、ner Qualittsmerkmale kann nach Feststellen der relevanten Merkmalswerte folgende Skala verwendet werden: Ohne Mngel Die Qualitt oder ein festgestellter Merkmalswert des Dokumentes entsprechen in jeder Hin- Sicht dem vorgesehenen Verwendungszweck. Leichte Mngel Das Dokument weist hinsichtlich seiner
42、Qualitt oder eines festgestellten Merkmalswertes Mngel auf, die durch Manahmen beseitigt oder umgangen werden knnen, fr die sich der erforderliche Aufwand an Arbeit und Zeit im Rahmen des Geplanten oder blichen hlt. Das Dokument weist hinsichtlich seiner Qualitt oder eines festgestellten Merkmalswer
43、tes Mngel auf, die nur durch Manahmen beseitigt oder umgangen werden knnen, fr die der erforderliche Aufwand an Arbeit und Zeit den Rahmen des Geplanten oder blichen ber- steigt, oder durch die die Verwendung des Dokumentes eingeschrnkt wird. Ausschlieende Mngel Das Dokument weist hinsichtlich seine
44、r Qualitt oder eines festgestellten Merkmalswertes Mngel auf, die seine weitere Verwendung in der vorliegenden Form ausschlieen. Durch Vergleich des erreichten Einstufungsniveaus mit den aus dem Verwendungszweck des Dokumentes resultierenden Anforderungen It sich die Eignung des Dokumentes fr die fe
45、stgelegte Verwendung beurteilen (Modell des Bewertungs- prozesses siehe 5.3 in DIN 66272 : 1994-10). Schwere Mngel Anhang B (informativ) Beziehungen zwischen Proze-, Produkt- und Dokumentenqualitt Proze-, Produkt- und Dokumentenqualitt hngen in der in Bild B.l angegebenen Weise voneinander ab. Ein E
46、ntwick- lungsproze erzeugt ein Produkt, dessen Qualitt von der Qualitt dieses Prozesses abhngt. Das Produkt erfllt die fest- gelegten oder vorausgesetzten Erfordernisse entsprechend seiner Produktqualitt. Da sowohl der Proze als auch das Produkt und sein Einsatz durch Dokumente beschrieben und teilw
47、eise anhand dieser Dokumente auch gesteuert werden, hngt ihre Qualitt von der Qualitt dieser Dokumente ab. erzeugt erfi I t entsprechend entsprechend Prozequai i tat I Produktquai i tat/ / beschreiben beschreiben beschreiben und steuern und steuern entsprechend Dokumentenquai itt I / I / Bild B.l: Beziehungen zwischen ProzeB-, Produkt- und Dokumentenqualitt
