Difference between revisions of "Benutzerhandbuch"

From ADempiere
Jump to: navigation, search
This Wiki is read-only for reference purposes to avoid broken links.
(Rollen)
 
(26 intermediate revisions by 2 users not shown)
Line 1: Line 1:
'''Ziel''': Erstellung eines Benutzerhandbuchs für ADempiere<br>
+
===Ziel===
aber nicht nur "ein" Handbuch. Wir wollen die Möglichkeit schaffen, unterschiedliche Handbücher, z.B. für Administratoren, Integratoren, Endanwender, etc. zu erzeugen. Außerdem wollen wir '''gemeinsam''' auch an der Dokumentation arbeiten.
+
  
'''Arbeitspaketverantwortlichkeit''':
+
Erstellung eines Benutzerhandbuchs für ADempiere, das sich an Geschäftsprozessen orientiert und als Zielgruppe den Nicht-Techniker adressiert.
  
'''Mitglieder''':Georg Schütz, Norbert Wessel, Mark Ostermann
+
===Arbeitspaketverantwortlichkeit===
  
'''Vorschlag für Inhaltsverzeichnis'''
+
[[User:nwessel|Norbert Wessel]] (Georg Schütz)
  
*Einführung
 
*Grundlagen
 
*Stammdatenpflege
 
*Prozesse
 
**Verkauf
 
**Einkauf
 
**Materialwirtschaft
 
  
'''Vorschlag für Technik'''
+
===Vorgehensweise===
*Werkzeug TeX/LaTeX
+
*Bereitstellung einer Deutschen AVA in der aktuellen Trunk-Version
*Dateiablage in einem Repository
+
*Erstellung eines Inhaltsverzeichnisses: [[User:nwessel|Norbert Wessel]] => [[Benutzerhandbuch:Inhaltsverzeichnis]]
*Screenshots als .png
+
*Entwicklung von Standard-Stilelementen: [[User:nwessel|Norbert Wessel]] => [[Benutzerhandbuch:Hilfe]]
 +
*Erstellung einer Vorlagen-/Beispielseite: [[User:nwessel|Norbert Wessel]] => [[Benutzerhandbuch:Angebot erstellen]]
 +
*Freiwillige Eintragung von Mitgliedern für Kapitel des Inhaltsverzeichnisses mit Namen und Aufwandsschätzung: Jeder
  
* Alternativ könnte [http://dita.xml.org DITA] als Dokumentationsstandard mit entsprechenden Tools genutzt werden.
+
===[[Benutzerhandbuch:Inhaltsverzeichnis|Inhaltsverzeichnis]]===
  
Dokumentieren mit LaTeX oder DITA hat viele Vorteile:
 
*Verteiltes Schreiben, weil nicht in WYSIWY(P)G (What you see is what you probably get) sondern in "What you write is what you mean" gearbeitet wird.  Einzelne Kapitel oder Abschnitte können in separate Text-Dateien verpackt werden
 
*Nummerierungen, Referenzen und Verzeichnisse automatisch werden richtig aufgelöst
 
*Es können nahezu beliebige Ausgabeformate erzeugt werden. Vom .pdf über html bis hin zur Steuerung von Druckmaschinen ist fast alles möglich
 
*Für alle Plattformen (insbesondere Linux, Mac und Windows) verfügbar
 
  
DITA bietet darüber hinaus:
+
===Rollen===
*Cross-Media Publikation
+
*Know-How-Träger, die ADempiere aus der Praxis beschreiben können
*Themenorientiertes Single-Sourcing (LaTeX ist dagegen dokumentenorientiert)
+
*Autoren, die Texte lesbar und verständlich machen
*XML-basiert, daher unmittelbar nahezu überall verwendbar
+
*Tester, die die Ergebnisse in der Anwendung nachvollziehen
 +
 
 +
===Mitglieder===
 +
    * metas
 +
    * KaMUX
 +
    * Evenos
 +
    * BayCIX
 +
    * Action42
 +
 
 +
 
 +
===Technik===
 +
 
 +
Anforderung an die Technik: KISS = Keep it simple and stupid
 +
 
 +
Wunsch: Werkzeug benutzen, dass Leute bereits kennen, um die Hürde fürs Mitmachen so klein wie möglich zu halten
 +
 
 +
Vorschlag: bestehendes Wiki nutzen
 +
 
 +
Vorteile:
 +
*einfache Benutzung
 +
*sofort Verfügbar
 +
*Skalierbarkeit: Aus einem MediaWiki lassen sich die Inhalte in ein x-beliebiges Format (wie z.B. Latex) exportieren und später weiter
 +
Nebeneffekt: Die erstellen Inhalte stehen automatisch unter der GNU Free Documentation License 1.2 und sind damit frei verfügbar.
 +
 
 +
 
 +
 
 +
 
 +
[[Category:Deutsche Lokalisierung]]
 +
[[Category:Benutzerhandbuch]]

Latest revision as of 07:54, 13 February 2008

Ziel

Erstellung eines Benutzerhandbuchs für ADempiere, das sich an Geschäftsprozessen orientiert und als Zielgruppe den Nicht-Techniker adressiert.

Arbeitspaketverantwortlichkeit

Norbert Wessel (Georg Schütz)


Vorgehensweise

Inhaltsverzeichnis

Rollen

  • Know-How-Träger, die ADempiere aus der Praxis beschreiben können
  • Autoren, die Texte lesbar und verständlich machen
  • Tester, die die Ergebnisse in der Anwendung nachvollziehen

Mitglieder

   * metas 
   * KaMUX 
   * Evenos
   * BayCIX
   * Action42 


Technik

Anforderung an die Technik: KISS = Keep it simple and stupid

Wunsch: Werkzeug benutzen, dass Leute bereits kennen, um die Hürde fürs Mitmachen so klein wie möglich zu halten

Vorschlag: bestehendes Wiki nutzen

Vorteile:

  • einfache Benutzung
  • sofort Verfügbar
  • Skalierbarkeit: Aus einem MediaWiki lassen sich die Inhalte in ein x-beliebiges Format (wie z.B. Latex) exportieren und später weiter

Nebeneffekt: Die erstellen Inhalte stehen automatisch unter der GNU Free Documentation License 1.2 und sind damit frei verfügbar.