-
Programmdokumentation erstellen (Womit, Wie)?
Hallo zusammen,
ich nutze dieses klasse Forum schon seit längerem. Nun ist es aber an der Zeit für den ersten Thread
In unserer Firma sitzen Anwendungsentwickler (zu denen ich mich auch zähle) und -nutzer unter einem Dach. Gerade weil wir unsere Software niemandem verkaufen, tun wir uns mit einer Doku sehr schwer. Bisherige Versuche mit einer Lotus Notes DB und dem aktuellen Ansatz, Dokus zu einem Projekt in einem Netz-LW abzulegen (meist mit Office erstellt),
können nicht als erfolgreich bezeichnet werden.
Wir sind nun deshalb auf der Suche nach einer frischen modernen Lösung.
Die Anforderungen:- Suchfunktion über Titel + Inhalt
- klar da müssen Bilder mit rein
- Kategorisierung
- leicht zu bearbeiten und erstellen
Da ich selbst schon seit vielen Jahren aus privatem Interesse PHP programmiere und ein leidenschaftlicher Nutzer des Internets bin, dachte ich sogleich an MediaWiki (Softwarebasis von Wikipedia). Leider ist hier das Erstellen von Artikeln etwas gewöhnungsbedürftig. Nicht jeder unserer Programmierer surft so oft im Inet und ist mit Board-Codes oder HTML-Code vertraut.
Das Optimum wäre demnach ein MediaWiki (browserbasiert find ich irgendwie am besten ), das man im Stil von Word bearbeiten kann. Nicht zu vergessen ist auch, dass die bestehenden Dokus in Word und Notes ohne rießigen Zeitaufwand in das neue System integriert
werden können.
Über ein paar Anregungen wäre ich sehr dankbar.
MfG ReKoR
-
Zitat von ReKoR
Das Optimum wäre demnach ein MediaWiki (browserbasiert find ich irgendwie am besten ),
Wir arbeiten inzwischen auch mit MediaWiki - mehrere Wikis für interne Doku für die Entwickler bis zur User-Doku, die man per Mausklick aus dem GreenScreen aufrufen kann. Ist meines Erachtens einfach und praktikabel. Nur nimm (bei gewisser Anzahl User) eine Linux-Möhre, auf der iSeries zieht PHP/MySQL doch recht viel Leistung...
(ich habe ein Wiki sogar mit XAMPP unter Windows laufen. Funktioniert sogar ;-)
-h
-
Hallo Holger,
danke für die Antwort.
Zitat von holgerscherer
Wir arbeiten inzwischen auch mit MediaWiki
Wie funktioniert das bei euch genau? Dürfen alle etwas schreiben, so wie es sich im Wiki gehört? Wenn ja, wie kommen die User mit der Syntax zurecht? Ich denke, dass das der Knackpunkt ist. Die Begeisterung hielt sich in Grenzen, als ich meine kleine Testanwendung mal vorgeführt habe.
Zitat von holgerscherer
[..] die man per Mausklick aus dem GreenScreen aufrufen kann.
Wie funktioniert das? Über ClientAccess?
Zitat von holgerscherer
ich habe ein Wiki sogar mit XAMPP unter Windows laufen. Funktioniert sogar ;-)
Dito! Mein Testwiki läuft auf ebenso unter XAMPP auf meinem privaten PC, auf den ich via Internet zugreife
-
Ich könnte mir vorstellen, dass der Link per STRPCCMD an den CA gesendet wird welcher wiederum den Befehl ausführt. Oder?
-
Zitat von prsbrc
Ich könnte mir vorstellen, dass der Link per STRPCCMD an den CA gesendet wird welcher wiederum den Befehl ausführt. Oder?
Nuja, meine GUI macht das natürlich anders, da platziere ich Buttons nach Belieben, aber fast jede 5250-Emulation macht
aus dem Text "http://www.mywiki.xyz/artikel.php/blabla" einen klickbaren Button.
-h
-
Zitat von ReKoR
Dürfen alle etwas schreiben, so wie es sich im Wiki gehört? Wenn ja, wie kommen die User mit der Syntax zurecht?
Mit der Syntax kommt man mit der Zeit schon klar, zur not kann man redaktionell nachbearbeiten - der Inhalt ist auch wichtig.
Schreibzugriff sollte abhängig von der Art der Doku sein:
- willst Du eine unternehmensweite Wissensbasis aufbauen, sollte jeder schreiben dürfen, der was beizutragen hat
- das Entwickerwiki wird nur von den Entwicklern beschrieben und ist auch nur für diese lesbar
- die Userdoku wird von Entwicklern und "Hilfsredakteuren" (ähm) bestückt und kann von jedem gelesen werden.
-h
Similar Threads
-
By I0N in forum IBM i Hauptforum
Antworten: 7
Letzter Beitrag: 09-01-09, 17:38
-
By mama in forum NEWSboard Drucker
Antworten: 11
Letzter Beitrag: 23-10-06, 19:59
-
By Techniker in forum IBM i Hauptforum
Antworten: 5
Letzter Beitrag: 09-08-06, 12:20
-
By Jörg Schmidt in forum NEWSboard Drucker
Antworten: 7
Letzter Beitrag: 03-08-06, 08:56
-
By KM in forum NEWSboard Java
Antworten: 3
Letzter Beitrag: 08-06-06, 09:09
Berechtigungen
- Neue Themen erstellen: Nein
- Themen beantworten: Nein
- You may not post attachments
- You may not edit your posts
-
Foren-Regeln
|
Erweiterte Foren Suche
Google Foren Suche
Forum & Artikel Update eMail
AS/400 / IBM i
Server Expert Gruppen
Unternehmens IT
|
Kategorien online Artikel
- Big Data, Analytics, BI, MIS
- Cloud, Social Media, Devices
- DMS, Archivierung, Druck
- ERP + Add-ons, Business Software
- Hochverfügbarkeit
- Human Resources, Personal
- IBM Announcements
- IT-Karikaturen
- Leitartikel
- Load`n`go
- Messen, Veranstaltungen
- NEWSolutions Dossiers
- Programmierung
- Security
- Software Development + Change Mgmt.
- Solutions & Provider
- Speicher – Storage
- Strategische Berichte
- Systemmanagement
- Tools, Hot-Tips
Auf dem Laufenden bleiben
|
Bookmarks