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

Alltag in einem mittelständischem Unternehmen. Im Vorbeigehen bekommt der ohnehin schon hart im Crunch1 arbeitende Entwickler den Hinweis: “Machst Du bitte für dieses Projekt in der Übersicht aller Kunden auch noch die offenen Rechnungen sichtbar?” Er kann nur pflichtbewusst nicken, weiß er doch, dass es sich um ein wichtiges Projekt handelt, die Aufgabe keine technische Herausforderung ist und der Chef immer schnelle und unkomplizierte Lösungen mag. Also irgendwie “zwischendrin” am späten Nachmittag die UI “aufbohren”, zusätzliche Abfragen im Frontend “packen”, die entsprechende Logik im Backend “anpassen”, mit den ermittelten Ergebnissen neue Listen in Views “zimmern”. Die extra Meile geht er mit dem Anklickbar machen und Öffnen der Rechnungen. Zufrieden lehnt der Entwickler sich kurz vor Mitternacht mit dem guten Gefühl zurück, die Anwendung weiter gebracht zu haben. Read more

Für ein Audit (TISAX) eines mittelständischen Unternehmens verwende ich erstmalig Bookstack1 zur Dokumentenlenkung und Steuerung. Ich bin sehr angetan. Besonders das rollenbasierte Zugriffskonzept und die automatische Versionierung gefallen sehr. Gemeinsames Arbeiten mit Nicht-IT-Menschen wird hier leicht gemacht. Kein Vergleich mit dem Krampf, den andere mit statischen Excel-Tabellen und Lose-Datei-Sammlungen auf SMB-Shares haben. Der Einsatz von Excel ist für mich Heuristik für falsch verstandene Digitalisierung und kaputte digitale Prozesse. Read more