Verslag van Joomla Maintenance Team Sprint: De eerste stappen richting Joomla 7.0
Het is 6 juni
Het Joomla Maintenance Team ging eindelijk aan de slag met iets waar we al jaren over praten: het daadwerkelijk verwijderen van verouderde (deprecated) code waar we ontwikkelaars al zo lang voor waarschuwen.
Wie al langer met Joomla werkt, kent het patroon. We markeren iets als deprecated, beloven dat het "ooit" zal verdwijnen en vervolgens… blijft het gewoon bestaan. Soms jarenlang. Maar dat "ooit" is nu aangebroken. Joomla 7.0 komt eraan en de excuses zijn op.
Opruimen van oude code
De missie was eenvoudig: verouderde code opsporen en verwijderen.
We gingen door jaren aan deprecatie-waarschuwingen heen, discussieerden over de vraag of iemand die ene helpermethode uit 2015 nog gebruikt (spoiler: waarschijnlijk niet, maar er zal vast iemand klagen) en bereidden pull requests voor de 7.0-dev-branch voor.
Verouderde API's, oude helperfuncties en code die al lang geleden door modernere architecturen was vervangen: niets was veilig.
Minder legacy-code betekent minder hoofdpijn voor iedereen die verder bouwt op Joomla.
Meer dan 100 deprecatievermeldingen verwijderd
De balans van de dag:
-
Meer dan 100 deprecatievermeldingen verwijderd.
-
Meer dan 25 pull requests gemerged in de Joomla-codebasis.
-
Meer dan 23 pull requests verwerkt in de Joomla Manual-repository.
Die deprecatievermeldingen hebben jarenlang hun werk gedaan: ontwikkelaars waarschuwen dat bepaalde functies zouden verdwijnen. Inmiddels hadden ze hun doel bereikt en waren ze zelf overbodig geworden.
Tijd om ze met pensioen te sturen.
Deze opschoning maakt de codebasis ook toegankelijker voor nieuwe bijdragers. Het is immers lastig te begrijpen wat de huidige standaard is wanneer de helft van de code roept: "Gebruik mij niet meer!"
En blijkbaar geldt: zet een groep ontwikkelaars bij elkaar met als opdracht code te verwijderen, en ze gaan er volledig voor.
Documentatie bijgewerkt
Natuurlijk werd niet alleen code verwijderd.
Ook de documentatie werd bijgewerkt. Want code verwijderen zonder ontwikkelaars te informeren is niet bepaald vriendelijk.
Daarom werden meer dan 23 aanvullende pull requests ingediend in de Joomla Manual-repository om alles correct te documenteren.
Werk je aan Joomla-extensies? Raadpleeg dan tijdig de migratiehandleiding zodat je goed voorbereid bent op Joomla 7.0.
Waarom is dit belangrijk?
Deprecaties zijn niet bepaald een spannend onderwerp. Niemand schrijft enthousiast een blogartikel met de titel:
"Kijk eens naar deze API die we hebben verwijderd!"
Toch is dit precies het soort onderhoudswerk dat een open-sourceproject gezond houdt. Of juist langzaam onderuit haalt wanneer het wordt genegeerd. Het doel is om verouderde functionaliteit op te ruimen, terwijl er duidelijke migratiepaden beschikbaar blijven voor ontwikkelaars.
Dat is de balans die nodig is.
De sprint van 6 juni liet zien hoe dat werkt:
-
Kom opdagen.
-
Duik in de code.
-
Verwijder wat niet meer nodig is.
-
Doe dat op een verantwoorde manier.
Er staat nog veel meer opruimwerk op de planning naarmate Joomla 7.0 verder vorm krijgt, maar de eerste belangrijke horde is genomen.
Dank aan alle deelnemers
Dank aan iedereen die heeft meegewerkt, code heeft beoordeeld, getest en er in het algemeen voor heeft gezorgd dat niet alles kapot ging:
-
Allon Moritz
-
Benjamin Trenkle
-
Christiane Maier-Stadtherr
-
Hannes Papenberg
-
Harald Leithner
-
Martin Kopp
-
Richard Fath
-
Tuan Pham Ngoc
-
Viviana Menzel
Samen hebben zij de eerste grote schoonmaak richting Joomla 7.0 mogelijk gemaakt.