Tool zur Dokumentantion

[leibnitz]

Hallo
ich suche ein Tool, dass es mir ermöglicht, recht einfach eine Dokumentation zu erstellen.

Bei dem Tools sollte es möglich sein ein Standart Layout zu hinterlegen wonach die ganzen Abschnitte dann formatiert werden.

Zusätzlich wäre es super, wenn das Tool online verfügbar ist und die Doku dann online anschauen kann, aber auch als PDF Exportieren kann.

Sone Art CMS für Dokumentationen.

Kennt jemand so ein Tool?

MfG Leibnitz

[Adromir]

Für welche Programmiersprachen brauchst du es denn? Für PHP gibts da z.B PHPdoc oder für Java gibt es Javadoc.

Wie es für andere Sprachen aussieht, kann ich dir leider nicht sagen..

[leibnitz]

Ich brauch das nicht für eine Scriptsprache sondern für ne Dokumentation in Form einer Bedienungsanleitung.

Das ganze wäre auch in Word etc möglich, nur die ganzen Seiten einzeln zu formatieren ist etwas umständlich und langwierg!!

Möchte halt einmal das design festlegen und dann wird der rest danach formatiert. z.B. wie bei HTML und CSS

MfG Leibnitz

[Adromir]

Aber das machen diese Tools ja. Bei der Programmierung arbeitet man z.B. mit einem bestimmten Kommentarsyntax, das Tool geht dann automatisiert durch das Programm durch und erstellt eine komplette Dokumentation.

Ansonsten würde ich vieleicht eben wirklich ein CMS verwenden..

[leibnitz]

ich will ja nicht den PHP Code Dokumentieren

ich möchte eine Bedienungsanleitung schreiben.

Z.B

1. Wie füge ich neue Inhalte hinzu
2. wie ändere ich Inhalte
etc
etc

klar was ich meine? :-)

[danis`]

Du kannst doch auch in Word eine Vorlage verwenden,
und selber eine erstellen.
Da passt sich dann auch jede Seite automatisch an..

[leibnitz]

ja schon nur wenn ich ne vorlage erstelle, muss ich ja auch bei jeder seite die formatierung der schriftenetc machen. das wird bei größerem umfang einfachumständlich und zeitaufwendig.

[seb]

Was spricht denn gegen ein ganz normales Textverarbeitungsprogramm? Du kannst doch auch dort Designvorlagen erstellen und wiederverwenden. Ich mein, für genau sowas sind solche Programme doch da. Falls Dir die Gestaltungsmöglichkeiten dabei nicht ausreichen, könntest Du es auch mit einem DTP-Programm versuchen. Ein CMS (gleich welcher Art) erscheint mir für sowas jedenfalls eher ungeeignet (auch wenn Webentwicklern die Vorstellung schwer fällt, dass es auch Dinge gibt, die man ohne ein CMS erledigen kann ).

[edit]Ups...das war jemand schneller. Das kommt davon, wenn man auf "antworten" klickt, danach erstmal wegrennt und erst 5 Minuten später schreibt .

[seb]

Ich weiß nicht, wie das bei Word funktioniert, aber bei OpenOffice kannst Du für das gesamte Dokument festlegen, wie verschiedene Textelemente formatiert werden sollen, im Prinzip genauso wie bei CSS. Bei Word geht das mit Sicherheit auch.

[Cybergreek]

...Bei Word geht das mit Sicherheit auch.

und dort heißt es "Formatvorlage"

[danis`]

ja schon nur wenn ich ne vorlage erstelle, muss ich ja auch bei jeder seite die formatierung der schriftenetc machen. das wird bei größerem umfang einfachumständlich und zeitaufwendig.

sicher geht das bei word auch.

[leibnitz]

hi

habs mir in Word jetzt nochmalangeschaut, dass ganze mit den Formatvorlagen etc kenn ich ja schon. Trotzdem ist Word Meinermeinung nach kein Tool zum schreiben von Dokumentationen über zig Seiten.Die Übersicht geht dabei weit verloren.

Außerdem besteht hier das Problem, das das ganze ja auch noch Webbasierend zu Verfügung stehen sollte das kann ich ja dann mit Word vergessen. Wenn ich das ganze als HTML exportiere siehts ja total unsauber etc aus.

MfG Leibnitz

[steff11]

moin leibnitz,
ich les von dir: ich will, nein, ich will nicht, so soll es sein ...

Es wär an der zeit, sich mal mit einem Wort zu bedanken. Die verfügbaren Optionen wurden nämlich genannt.

[danis`]

Moin,
kein "wirkliches" Tool zum Doku schreiben, benutzt mein Projektleiter aber auch immer: MindManager
kann man dann in Word exportieren und ich glaube auch als HTML und PHP.
Wird dann auch mit Inhaltsverzeichniss am Anfang angezeigt etc.

[leibnitz]

moin leibnitz,
ich les von dir: ich will, nein, ich will nicht, so soll es sein ...

Es wär an der zeit, sich mal mit einem Wort zu bedanken. Die verfügbaren Optionen wurden nämlich genannt.

morgen,

was soll den der scheiß jetzt? Ich hab doch nur gesagt, das Word meinermeinung nach bei einer Anzahl von mehreren Seiten unübersichtlich wird. Darf man hier nicht seine Meinung äußern?

Ich benötige einfach solch eine Lösung und wenn es diesen Funktionsumfang nicht gibt, muss ich mir selbst was bastelt. Ich möchte einfach nicht die Arbeit 2 Mal machen einmal für Web und einmal für Print.

Moin,
kein "wirkliches" Tool zum Doku schreiben, benutzt mein Projektleiter aber auch immer: MindManager
kann man dann in Word exportieren und ich glaube auch als HTML und PHP.
Wird dann auch mit Inhaltsverzeichniss am Anfang angezeigt etc.

Danke werds mir mal anschauen.

MfG Leibnitz