Seit dem 22. Dezember 2023 setze ich künstliche Intelligenz (KI) hier auf dem News-Blog für Großrinderfeld und den Main-Tauber Kreis ein. Das hat mir durchaus auch kritische Kommentare eingebracht. Einige haben die Befürchtung, dass nur noch „automatischer Text“ erscheint. Das ist aber bei Weitem nicht der Fall! KI nutze ich zur Unterstützung. In jedem Artikel steckt immer noch viel manuelle Arbeit – oft mehr als zuvor.
Möchten Sie News aus Großrinderfeld und dem Main-Tauber Kreis direkt in WhatsApp erhalten? Dann abonnieren Sie meinen Kanal (hier). Wichtig: niemand sieht Ihre Telefonnummer!
Den KI Einsatz habe ich in meinem beruflichen Umfeld als Leiter des rsyslog open source Projekts begonnen. Ich habe ihn danach auf das News-Portal ausgeweitet. Für das rsyslog Blog habe ich nun einen Artikel verfasst, der meinen KI Einsatz und die Motivation dahinter beschreibt. Da meine Motivation hier die gleiche ist, habe ich den Artikel mittels KI übersetzen lassen und poste ihn auch hier. Er zeigt gut meine Intention. Die Übersetzung habe ich übrigens nur leicht manueller nachbearbeitet. Auf geht’s…
Wie KI zur Verbesserung der rsyslog Dokumentation eingesetzt wird
Lange Zeit hatte ich Probleme mit der schwierigen Aufgabe, die Dokumentation für Rsyslog zu verbessern. Mein umfassendes Wissen über die Rsyslog-Technologie machte es mir oft schwer, benutzerfreundliche Dokumentation zu erstellen, insbesondere für Personen mit wenig oder gar keiner Erfahrung mit Syslog. Darüber hinaus war mir als Nicht-Muttersprachler in Englisch bewusst, dass einige meiner Sätze möglicherweise schwieriger zu verstehen sind als gewünscht. Aber dank der Fortschritte in der Generativen Künstlichen Intelligenz (KI) hat sich das Blatt gewendet und eine neue Ära der Dokumentationsverbesserung hat begonnen.
Nutzung von KI – eine lange Reise…
Anfang 2023 starteten wir eine erste Runde von KI-Tests, aber die Ergebnisse waren sehr ernüchternd. Es war erst Mitte November, als ich beschloss, nochmals und tiefer in die Welt der KI einzutauchen, diesmal mit dem Fokus auf die Verwendung von KI als Tool zur Verbesserung unserer Dokumentation. Zu dieser Zeit hatten sich die Werkzeuge auch schon deutlich verbessert. Ich begann mit einfachen Aufgaben zur Texterstellung und experimentierte sogar damit, KI ganze Artikel automatisch generieren zu lassen. Während die Ergebnisse bei weitem nicht perfekt waren, zeigten sie brauchbare Ansätze. Zumindest als Grundlage für manuelle Bearbeitung.
Durch diesen Prozess habe ich gelernt, dass KI als wertvolles Teammitglied behandelt werden sollte. Sie eignet sich hervorragend für die Generierung von Standardinhalten, einschließlich häufig verwendeter Strukturen und Gliederungen, und kann uns bei der Formulierung von Sätzen und der Verbesserung der Details unserer Dokumentation erheblich unterstützen. Am wichtigsten ist, dass ich festgestellt habe, dass ich der KI technisch tiefgreifende Fakten über Rsyslog bereitstellen kann, die sie dann in benutzerfreundliche Inhalte für Anfänger umwandeln kann. Das ist großartig und genau das, was ich suchte. Es gab mir die Zuversicht, doch selbst die Verbesserung der rsyslog Dokumentation übernehmen zu können. Während das Endergebnis sicherlich nicht perfekt sein wird, wird es sicherlich eine deutliche Verbesserung gegenüber dem bisherigen Stand sein.
Einschränkungen der KI
Es ist wichtig zu verstehen, dass KI keine magische Lösung zur Erzeugung vollständiger und fehlerfreier Texte aus vagen Ideen ist. Wenn sie mit übermäßig vagen Eingaben konfrontiert wird, kann KI Fehler, Auslassungen und sogar fiktive „Fakten“ (bekannt als „KI-Halluzinationen„) generieren. Dies ist insbesondere bei Nischentemen wie Syslog der Fall. Selbst in Bereichen mit reichlich Textressourcen, wie Reiseplanung und Urlaubsorten, kann KI Ungenauigkeiten generieren und manchmal sogar völlig falsche „Fakten“ erzeugen. Es ist daher sehr wichtig, sich dieser Einschränkungen bewusst zu sein.
Die Rolle der KI bei der Dokumentationsverbesserung
Die Verwendung von KI für die Rsyslog-Dokumentation zielt nicht darauf ab, Zeit zu sparen, sondern die Qualität unserer Dokumentation zu verbessern. In zukünftigen Beiträgen werde ich wahrscheinlich detaillierter auf meine KI-gesteuerten Prozesse eingehen. Bitte beachten Sie, dass dies immer noch ein bedeutender Aufwand ist, und der primäre Fokus liegt auf der Verbesserung der Gesamtqualität der Dokumentation. Wenn wir vorankommen, erwarten Sie schrittweise Fortschritte in der Lesbarkeit und Benutzerfreundlichkeit der Dokumentation.
Fazit
Die Integration von KI in unser Projekt zur Verbesserung der Dokumentation markiert einen bedeutenden Schritt nach vorne. Während KI kein Allheilmittel ist, hat sie das Potenzial, die Qualität unserer Rsyslog-Dokumentation zu verbessern und sie einem breiteren Publikum zugänglich zu machen. Bleiben Sie dran für weitere Updates zu dieser aufregenden Reise.