Previous Next V-Model Official Homepage by IABG  
Mail 0115  

1996-1997-1998-1999-2000-2001-2002

Contents  
  • Title
  • From
  • Date
  •  
  • History
  • Content
  • Links to V-Model
  • Title

    Re: Inf. zum Anwender- und Diagnosehandbuch (115)

    From

    Matthias Suilmann (suilmann@cci.de)

    Date

    Mon, 24 Nov 1997 09:20:20

    History

    Mail 0108

    Mail 0110

    Mail 0111

    Mail 0113 (Color: green)

    Mail 0115 (Color: black. This mail)

    Mail 0116

    Mail 0118

    Content

    > Die Trennung zwischen "INFORMATIONEN ZU DEN Anwender- und anderen 
    > Handbüchern" und den eigentlichen "Anwender- und anderen Handbüchern"
    > ist m.E. durch aus sinnvoll.
    > 
    > Die inhaltliche Ausgestaltung und Präsentation eines Handbuchs ist nicht
    > Gegenstand eines Entwicklungsprozesses. Handbücher sollten schließlich
    > nicht von Entwicklern geschrieben werden (wir alle haben sicherlich
    > schon unter derartigen Werken gelitten), sondern idealerweise von
    > technischen Redakteuren oder einer anderer Form von
    > Dokumentationsabteilung. Auch spielen Absprachen und Wünsche des Kunden
    > sowie Corporate-Design-Richtlinien des Herstellers eine große Rolle. 
    > Es wäre sicherlich zu viel verlangt, wenn das V-Modell auch hierfür
    > Richtlinien erlassen sollte.
    > 
    > Was das V-Modell hingegen regelt ist, welche Art von
    > technisch-inhaltlichen Informationen von der Entwicklung für die
    > Gestaltung eines Handbuchs **bereitgestellt** werden sollten, eben die
    > "INFORMATIONEN ZUM Handbuch". Dieses Dokument sollte also aus der Sicht
    > der Entwicklung alle Details sammeln, die ein technischer Redakteur
    > benötigt, um ein benutzerfreundliches, kundengerechtes und CD-konformes
    > Handbuch zu erstellen.
    > 
    > M.f.G.
    >    Roman Cunis
    > 
    ----[Dokumentation der bisherigen Diskussion gelöscht]--------------
    
    Die "Informationen zum Anwendungshandbuch" (egal, ob es die
    Informationen oder die Handbücher sind) sollen laut V-Modell 
    nicht von den Entwicklern geschrieben werden, sondern wie oben
    richtig gefordert von der Rolle "Technischer Autor".
    In allen Aktivitäten, in denen die Betriebsinformationen bearbeitet
    werden ist dementsprechend auch der Technische Autor als 
    "mitwirkend" aufgeführt. (VM97 Teil 3 Seite R14)
    
    Wenn ich die Beschreibung der Rolle lese, erhärtet sich der 
    Eindruck, daß die Verfasser des V-Modells mit dem Begriff
    "Informationen zum Anwendungshandbuch" tatsächlich das
    Anwendungshandbuch meinen. Denn der Technische Autor
    sammelt nicht nur Informationen, sondern  bereitet diese für
    unterschiedliche Zielgruppen auf und erstellt die Handbücher
    für Anwender und Systembetreuer. (VM97 Teil 3 Seite R8)
    
    MfG
    Matthias Suilmann
    
         _/_/_/ _/_/_/ _/_/_/ Matthias Suilmann  Telefon:         (05931) 805-471
        _/     _/       _/    CCI GmbH           Fax-PC-Suilmann: (05931) 842-471
       _/     _/       _/     Lohberg 10         Fax-Zentrale:    (05931) 805-100
      _/     _/       _/      49716 Meppen       E-Mail: suilmann@cci.de
     _/_/_/ _/_/_/ _/_/_/     http://www.cci.de

    Links to V-Model

    not defined

    Previous Next GDPA Online Last Updated 01.Jan.2002 Updated by Webmaster Last Revised 01.Jan.2002 Revised by Webmaster