1. Mai 2026, 07:55

Wie schreibe ich eine gute Git-Dokumentation

Du nutzt eine Versionskontrolle und Du möchtest Wissen festhalten oder weitergeben. Dieser Umstand allein zeigt, dass Du bereits einiges richtig machst. In diesem Beitrag erfährst Du, wie mit einer klaren und gut strukturierten Dokumentation die Qualität eines Projekts gesteigert werden kann. Egal ob es ein kleines Hobbyprojekt oder ein internes Konzern-Repo ist. Und mit Git-Dokumentation meine ich nicht nur die README allein. Viel Spaß beim Lesen! Gute Zusammenfassung als Einstieg Versuche, in einem Satz zusammenzufassen, was Dein Repository macht. Mit diesem Satz beginnt Dein Repo. Wenn Dir das nicht gelingt, ist das ein Zeichen dafür, dass Dein Fokus noch nicht klar genug ist. Read more

10. März 2026, 18:20

Wieder zurück aus dem Kaninchenbau

In den letzten Tagen bin ich wieder einmal im sprichwörtlichen Kaninchenbau versackt. Aber ganz von vorne: Am Samstag habe ich einen Blogbeitrag geschrieben, um einen automatisierten und deterministischen Dokumenten-Workflow zu veranschaulichen.1 Zur besseren Nachvollziehbarkeit habe ich außerdem ein Codeberg-Repository angelegt.2 Das Feedback war überraschend überwältigend und enthielt viele berechtigte Punkte. Tatsächlich war das Repo ursprünglich eher schnell als gründlich zusammengestellt, so dass ich es deutlich überarbeitet und im Zuge dessen auch umbenannt habe. Jetzt ist es mehr als nur ein Anschauungsobjekt. Es bildet nun einen vollständigen, sehr flexiblen und zugleich sehr einfachen Dokumenten-Workflow ab. Read more

8. März 2026, 16:40

ISMS as Code

Zum Wochenende habe ich auf Codeberg ein Beispiel-Repository veröffentlicht.1 Es enthält den methodischen Vorschlag, eine ISMS-Dokumentation wie Code zu behandeln. Konkretes Beispiel ist die ISO 27001 Risikobewertung von Assets in Organisationen. Im Mittelpunkt steht dabei weniger das konkrete Dokument als vielmehr das dahinterstehende Konzept. Geschrieben ist alles in einem universellen Text-Only-Format, das garantiert auch noch in 50 Jahren in jedem Editor bearbeitet werden kann: Markdown.2 Markdown hat dabei einige praktische Eigenschaften: Read more

17. November 2025, 15:10

Forgejo anpassen

Seit der letzten Blog-Serie zu Gitea vor über 5 Jahren ist einiges an Zeit vergangen.1 Inzwischen hat Gitea mit Forgejo einen leistungsstärkeren Fork erhalten,2 der längst Einzug in meine Praxis gefunden hat. Da ich unlängst meine Gitea Instanz als Jail auf der TrueNAS stilllegte,3 beschreibe ich heute, wie ich stattdessen eine Forgejo-Instanz an die eigenen Bedürfnisse angepasst habe. Nur informatorisch der Hinweis: Aus Einfachheit schreibe ich nur von Forgejo. Mir ist bekannt, dass vieles bei Forgejo und Gitea (noch) identisch ist. Es sollte aber klar sein, dass seit der Forgejo Version 10 diese kein Soft-Fork mehr ist.4 Langfristig entwickeln sich beide immer weiter auseinander. Read more

18. Oktober 2024, 12:30

Recap zu GitOps-Datensicherung und digitalen Zwillingen

Zu meinem Beiträgen mit den GitOps-Datensicherungen1 und digitalen Zwillingen2 haben sich einige Rückfragen angesammelt, die ich hier subsummieren möchte: Veeam kann aber viel mehr als Deine Lose-Script-Sammlung… Das ist unbestritten. Ich betrachte nur einen kleinen Bereich eines großen Portfolios. Am Ende des Tages geht es um vollständige und stets verfügbare Backups eines HyperV-Hypervisors mit seinen VMs. Eines, das schnell wieder auf einer frisch installierten Maschine befördert ist auch bei einer komplett abgebrannten Infrastruktur. Und da sieht ein meist im AD-integrierte Veeam mit seiner Business Continuity3 nicht gut aus. Read more

8. September 2024, 13:30

Backups in Unternehmen

Warum ist das Geschäftsmodell Ransomware so erfolgreich? Wie schaffen es Kriminelle Daten zu entwenden, zu verschlüsseln und häufig auch die Datensicherungen zu vernichten? Laut repräsentativer Umfrage der BITKOM in den vergangenen 12 Monaten bei 60% der Unternehmen in Deutschland.1 Ein kurzer Exkurs in diese Thematik, in meine Arbeit und wie ich einem Unternehmen helfen konnte, 17.000,- EUR zu sparen. Wie immer gilt, kein Anspruch auf Vollständigkeit und Allgemeingültigkeit. Your mileage may vary. Read more

9. August 2024, 16:40

Clipboard Auditor - Admintool (Win+Linux) auf codeberg.org

Zum Wochenende habe ich meinen Clipboard Auditor zum “Monitoring” von Copy & Paste Zwischenablagen als Repo zum Codeberg getragen.1 Ich denke, ich brauche niemanden großartig erklären, was sich mit dem Clipboard Auditor in Fernsteuerungen oder auf Terminalservern so alles anstellen lässt :-P Aufgrund einer Nachfrage, habe ich schnell noch eine Linux-Fassung für GTK (Gnome) nachgeschoben. In diesem Sinne, ein schönes Wochenende! Tomas Jakobs https://codeberg.org/tomas-jakobs/clipboard-auditor ↩︎

8. August 2024, 04:10

Profilecleaner - Admintool (Win) auf codeberg.org

Eine immer wiederkehrende Herausforderung hat mich dazu bewogen, ein universales CLI-Tool als Lösung zu erstellen. Die Aufgabenstellung: Benutzerprofile auf Windows RDSApp- und Terminalserver regelmäßig von temporären Dateien und Clutter bereinigen. Eine schnelle Internet-Recherche wirft drölfzig Powershell-Scripte als Problemlösung aus. Doch bei weiterer Betrachtung waren diese zu unflexibel, umständlich unhandlich und teilweise sogar falsch wenn z.B. ausgegangen wird, Windows-Benutzerprofile seien immer auf C:\Users zu finden. Und so habe ich schnell ein eigenes Tool “Profilecleaner” für die Kommandozeile geschrieben und stelle dieses als Binary mit Quellcode im Repo auf Codeberg.org zur Verfügung.1 Read more

8. Februar 2023, 03:50

Zentrale Heuristik der Digitalisierung

Unternehmen ohne git1 Repositories auf eigenen Servern haben keine Zukunft. Für mich ist das die zentrale Heuristik, ob ein Konzept wie “Infrastructure as Code” verstanden und gelebt wird. Fehlt dieses, sind alle Digitalisierungs- und Industrie 4.0 Projekte2 zum Scheitern verurteilt. Leider bezeichnend und für sich selbst sprechend: In der deutschsprachigen Wikipedia existiert kein Eintrag zu “Infrastructure as Code”.3 Daher ist es mir eine Ehre, git Workflows für ein mittelständisches Unternehmen auszuarbeiten und auszurollen. Nicht nur für die IT sondern ganz besonders für die werkseigenen Techniker und Ingenieure, die Anlagensteuerungen in den diversen Tools programmieren. Read more

© 2026 Tomas Jakobs - Impressum und Datenschutzhinweis

Mitglied im UberBlgr Webring:   < Zurück > Weiter >  

Unterstütze diesen Blog - Spende einen Kaffee