~/home of geeks
Maven to the rescue: Dokumentation mit Maven und AsciiDoc
Teil 8 der Serie "Maven to the rescue"
1365 Wörter
·
7 Minute(n) Lesedauer
Technische Dokumentationen sind ein komplizierteres Thema als manchmal gedacht: Welches Format, welcher Inhalt, wo und von wem soll die Dokumentation gepflegt werden? Insbesondere die Pflege der Dokumentation ist ein Dauerthema. Mit AsciiDoc und dem asciidoctor-maven-plugin lassen sich Dokumentationen in einem flexiblen Dokument pflegen, das Code nah als Modul im Projekt gepflegt und mit GIT versioniert werden kann.
| Weiterlesen
GiroCodes kennt man von Rechnungen und Überweisungsträgern: Man scannt mit seinem Handy ein QR-Code ab und schon wird in der Banking-App die Überweisung mit allen Daten befüllt. Bei der Verwendung von Google Docs zur Rechnungserstellung habe ich ein paar Skriptmethoden geschrieben, mit denen man das auch in Google Docs machen kann.
| Weiterlesen
Log-Meldungen während der Ausführung von Tests können verwirrend sein, insbesondere wenn Error-Level Meldungen mit Stacktraces ausgegeben werden, die im Rahmen des Tests vollkommen ok sind. Mit einem eigenen Filter für Log4j2 habe ich eine Möglichkeit gefunden, die Log-Meldungen während der Ausführung eines Blocks stummzuschalten.
| Weiterlesen
Als ich meine Webseite mit PageSpeed Insights analysierte, las ich zum ersten Mal von Cumulative Layout Shifts (CLS). Das ist ein Maß dafür, wie sehr sich die Elemente einer Webseite beim Laden verschieben.
| Weiterlesen
Bilder werden im Webseiten-Framework Hugo per Markdown definiert. Die Default-Ausspielung generiert ein einfaches Img-Tag mit dem hinterlegten Bild. Für dieses Blog habe ich ein Template entwickelt, welches verschiedene Bildauflösungen für verschiedene Geräte-Auflösungen generiert (responsive images).
| Weiterlesen
Maven to the rescue: Transitive Dependencies und verwaiste Dependencies nachhalten mit Maven
Teil 7 der Serie "Maven to the rescue"
1068 Wörter
·
6 Minute(n) Lesedauer
Schon kleine Projekte haben dank Open Source und Maven eine Menge Abhängigkeiten. Neben nicht mehr genutzten verwaisten Dependencies gibt es noch eine Klasse von Abhängigkeiten, die transitiven Abhängigkeiten (transitive dependencies), die besonders zu beachten sind.
| Weiterlesen
Bei Datenmigrationen, die über einen längeren Zeitraum laufen, ist es sinnvoll, den Migrator so zu gestalten, dass er zwischendurch beendet und neu gestartet werden kann. Ein Hilfsmittel hierzu ist eine Klasse, welche sich die ID der zuletzt migrierten Datensatzes persistent merkt.
| Weiterlesen