TYPO3 Changelog: Pflichtlektüre für Integratoren und Entwickler

TYPO3 entwickelt sich weiter. Was in einer Version jahrelang zuverlässig funktioniert hat, kann in der nächsten Version anders laufen oder komplett wegfallen. Das ist normal. Das Problem entsteht nicht durch die Änderung selbst, sondern dadurch, dass sie niemand mitbekommt.

Genau dafür gibt es den TYPO3 Changelog. Er dokumentiert jede relevante Änderung einer Version: Breaking Changes sind Änderungen, nach denen bestehender Code nicht mehr wie gewohnt funktioniert. Deprecations markieren Funktionen, die als veraltet gelten und in einer der nächsten Versionen komplett wegfallen. Dazu kommen neue Features und sonstige wichtige Hinweise. Wer das liest, bevor er mit einer neuen Version arbeitet, spart sich böse Überraschungen im Livebetrieb.

Der Changelog betrifft mehr Rollen, als man denkt

Der TYPO3 Changelog ist nicht nur für Entwickler relevant. Auch Integratoren und Consultants sollten regelmäßig reinschauen.

Für Integratoren ist offensichtlich, warum: Konfigurationen, TypoScript und Sitepackages reagieren direkt auf Änderungen am Core. Aber auch als Consultant kann man Kunden nur dann seriös beraten, wenn man weiß, was die aktuelle TYPO3-Version tatsächlich kann. Ohne aktuelles Wissen über den Funktionsumfang wird Beratung schnell zur Vermutung.

Klar, nicht jeder Changelog-Eintrag betrifft jede Rolle gleich stark. Aber mit wachsender Erfahrung entwickelt man ein Gespür dafür, welche Änderung für die eigene Arbeit relevant ist und welche nicht.

Wo du den TYPO3 Changelog findest

Alle TYPO3 Changelogs seit Version 7 sind zentral auf docs.typo3.org dokumentiert. Dort lassen sich Änderungen versionsweise nachlesen und filtern.

So gehe ich selbst damit um

Ich lese mir die Einträge tatsächlich durch, teilweise vollständig, teilweise reichen Überschrift und Zusammenfassung. Besonders genau schaue ich mir die Kategorien "Breaking" (Code, der danach nicht mehr funktioniert) und "Important" (Änderungen, die man kennen sollte, auch wenn nichts kaputtgeht) an, weil sie fast immer relevant sind, egal in welcher Rolle man unterwegs ist. Trotzdem überfliege ich auch die restlichen Einträge, weil man nie sicher weiß, was am Ende doch die eigene Arbeit betrifft.

Damit mir dabei nichts durchrutscht, habe ich mir einen Monitoring-Dienst eingerichtet: Wachete überwacht die Changelog-Seite und schickt mir eine E-Mail, sobald sich dort etwas ändert. So verpasse ich keine Aktualisierung, ohne die Seite jeden Tag manuell aufrufen zu müssen.

Vom Lesen zum Handeln

Eine Änderung gelesen zu haben, heißt nicht, sie auswendig zu kennen. Aber es hilft schon enorm, zu wissen: Das habe ich schon mal gelesen, das könnte jetzt relevant sein. Gerade wenn man mit mehreren TYPO3-Projekten auf unterschiedlichen Versionsständen arbeitet, taucht das ständig auf: Was in einem älteren Projekt A noch problemlos läuft, funktioniert in einem neuen, gerade geplanten Projekt Y plötzlich nicht mehr.

Wenn möglich, probiere ich Änderungen, die mich betreffen könnten, direkt in einem Testprojekt aus. Notfalls baue ich dafür ein kleines Testprojekt mit der Zielversion auf. So sehe ich schnell, ob und wie stark mich eine Änderung wirklich betrifft.

Für potenziell relevante Einträge lohnt sich außerdem eine einfache Ablage: ein Lesezeichen oder eine Liste in einem Tool wie Trello, Notion oder Obsidian. Im TCCI-Team machen wir das genauso: Änderungen, die uns möglicherweise betreffen, landen erst mal in Trello. Erst danach analysieren und testen wir sie konkret.

Wann du auf jeden Fall reinschauen solltest

Zwei Momente, in denen das Lesen des Changelogs nicht optional ist:

• Bevor du zum ersten Mal mit einer neuen TYPO3-Version arbeitest, egal ob Neuinstallation oder Upgrade eines Bestandsprojekts
• Bevor du dich zertifizieren lässt

Am besten wird daraus aber keine Ausnahme, sondern eine feste Routine. Genauso wie du dir Updates deiner Extensions ansiehst, gehört der Blick in den Changelog zum normalen Arbeitsalltag mit TYPO3.

Fazit

Der TYPO3 Changelog ist keine Pflichtübung nur für Entwickler, sondern relevant für alle, die professionell mit TYPO3 arbeiten, ob als Integrator, Entwickler oder Consultant. Er verhindert kaputten Code, unsichere Beratung und böse Überraschungen bei der Zertifizierung. Mit einer festen Routine und einem Monitoring-Tool wie Wachete lässt sich das ohne großen Aufwand in den Alltag integrieren.