Archive old talks

upgrading-to-drupal-9/README.rst

@@ -1,4 +0,0 @@
-Upgrading to Drupal 9
-#####################
-
-https://www.oliverdavies.uk/talks/upgrading-your-site-drupal-9

upgrading-to-drupal-9/main.style

@@ -1,126 +0,0 @@
-pageSetup:
-    firstTemplate: coverPage
-    height: 18cm
-    margin-bottom: 0cm
-    margin-gutter: 0cm
-    margin-left: 0cm
-    margin-right: 0cm
-    margin-top: 0cm
-    size: null
-    spacing-footer: 2mm
-    spacing-header: 2mm
-    width: 32cm
-
-pageTemplates:
-    coverPage:
-        frames: []
-            [12%, 10%, 76%, 75%]
-        showFooter: false
-        showHeader: false
-
-    titlePage:
-        alignment: TA_CENTER
-        frames: []
-            [8%, 8%, 85%, 60%]
-        showFooter: true
-        showHeader: false
-
-    standardPage:
-        frames: []
-            [3%, 3%, 94%, 92%]
-        showFooter: true
-        showHeader: false
-
-    imagePage:
-        alignment: TA_CENTER
-        frames: []
-            [12%, 10%, 76%, 80%]
-        showFooter: true
-        showHeader: false
- 
-linkColor: #24608a
-
-fontsAlias:
-    stdMono: Inconsolata-Regular
-    stdMonoBold: Inconsolata-Regular
-    stdMonoItalic: Inconsolata-Regular
-
-styles:
-    normal:
-        fontSize: 28
-        textColor: #383745
-
-    bodytext:
-        alignment: TA_LEFT
-
-    heading:
-        alignment: TA_CENTER
-        fontSize: 24
-        spaceAfter: 16
-        textColor: #24608a
-
-    heading1:
-        parent: heading
-        alignment: TA_LEFT
-
-    title:
-        fontSize: 250%
-        parent: heading
-
-    bullet-list:
-        commands: []
-             [LEFTPADDING, [0, 0], [1, -1], 10]
-             [RIGHTPADDING, [0, 0], [1, -1], 0]
-             [VALIGN, [0, 0], [-1, -1], TOP]
-        colWidths: ["20", null]
-        textColor: #aaaaaa
-
-    bullet-list-item:
-        spaceBefore: 14
-        spaceAfter: 0
-
-    titleslideinfo:
-        alignment: TA_CENTER
-        fontSize: 120%
-        parent: normal
-
-    footer:
-        alignment: TA_RIGHT
-        fontName: stdMono
-        fontSize: 18
-        textColor: #24608a
-        rightIndent: 16
-        spaceBefore: 0
-
-    literal:
-        backColor: white
-        fontName: stdMono
-
-    code:
-        backColor: white
-        borderWidth: 0
-        fontSize: 24
-        parent: literal
-        spaceBefore: 4
-    
-    blockquote:
-        parent: normal
-        fontName: stdItalic
-
-    attribution:
-        parent: normal
-        textColor: #666666
-
-    smaller:
-        textColor: red
-
-    centredtitle:
-        alignment: TA_CENTER
-        fontName: stdBold
-        fontSize: 48
-        leading: 64
-        parent: heading
-
-    centred:
-        alignment: TA_CENTER
-        parent: normal

upgrading-to-drupal-9/slides.rst

@@ -1,488 +0,0 @@
-.. footer:: @opdavies
-
-Upgrading to Drupal 9
-#####################
-
-|
-
-.. class:: titleslideinfo
-
-Oliver Davies, Inviqa
-
-.. raw:: pdf
-
-  PageBreak imagePage
-
-.. image:: images/10-years-tweet.png
-    :width: 22cm
-
-.. raw:: pdf
-
-    TextAnnotation "Recently, I passed 10 years working full-time with Drupal and PHP (I'd been working with it for a few years prior to this too)."
-    TextAnnotation "Worked with Drupal 6, 7, 8 and 9."
-    TextAnnotation "Worked on a number of D6 to D7, and D8 to D9 upgrades"
-
-    PageBreak standardPage
-
-The D7 release cycle
-====================
-
-* One long-running branch
-* Minor versions for bug fixes (7.80, April 2021)
-* No big, new features
-* Long time for changes to get committed to core
-
-.. raw:: pdf
-
-    TextAnnotation "Before we get into the D9 stuff."
-    TextAnnotation "D7 and earlier..."
-
-The D8 release cycle
-====================
-
-* Semantic versioning for core
-* Minor release (new features) every 6 months
-* Patch release (bug fixes) every month
-* Multiple supported versions of core (8.9, 9.0, 9.1)
-
-.. raw:: pdf
-
-    TextAnnotation "Drupal 8 onwards..."
-    TextAnnotation "Minor release = new functionality"
-    TextAnnotation "Patch release = bug fixes"
-    TextAnnotation "Change from 'it will be ready when it's ready' (D7) to a fixed release cycle and schedule, and what makes it in time will be added."
-    TextAnnotation "8.9 is an LTS release"
-
-.. raw:: pdf
-
-    PageBreak imagePage
-
-.. image:: images/2019_minor_release_schedule.png
-    :width: 20cm
-
-.. raw:: pdf
-
-    PageBreak standardPage
-
-Drupal 8 vs Drupal 9
-====================
-
-* No new functionality
-* Deprecated code removed
-* PHP required version increased
-* Major versions of dependencies updated
-
-.. raw:: pdf
-
-    TextAnnotation "Different to previous major version updates"
-    TextAnnotation "Symfony upgraded from 3 to 4."
-
-Previous upgrade issues
-=======================
-
-* Lots of breaking changes
-* Core released, but contrib takes time to catch up
-
-.. raw:: pdf
-
-    TextAnnotation "Lots of breaking changes, large rebuilds and migrations"
-    TextAnnotation "6(?) months between D7 core and Views being released, prevents adoption"
-    TextAnnotation "Jeff Geerling blog post 'Did breaking backwards compatibility kill Drupal?'"
-
-Contrib improvements
-====================
-
-* Minimal code changes required
-* Single release can support multiple versions of core
-* Semantic versioning enabled for contrib projects
-
-.. raw:: pdf
-
-    TextAnnotation "Need to fix deprecation notices, and replace deprecated code with the suggested replacements"
-    TextAnnotation "Modules, themes and distributions can now work with multiple versions of Drupal core in the same release"
-    TextAnnotation "`core` key replaced with `core_version_requirement`"
-
-    PageBreak imagePage
-
-.. image:: images/multiple-versions.png
-    :width: 20cm
-
-|
-
-.. image:: images/semver.png
-    :width: 20cm
-
-.. raw:: pdf
-
-    PageBreak titlePage
-
-.. class:: centredtitle
-
-The difference  is deprecated code
-
-.. raw:: pdf
-
-    TextAnnotation "Code that has been replaced by newer code and marked to be removed."
-    TextAnnotation "Not removed immediately to keep backwards compatibility."
-    TextAnnotation "A backwards compatibility break would require a major version change rather than a minor one."
-
-    PageBreak standardPage
-
-Deprecation example
-===================
-
-.. code-block:: php
-    :startinline: true
-
-    function drupal_set_message($message = NULL, $type = 'status', $repeat = FALSE) {
-      @trigger_error('drupal_set_message() is deprecated in Drupal 8.5.0 and will
-      be removed before Drupal 9.0.0. Use \Drupal\Core\Messenger\MessengerInterface
-      ::addMessage() instead. See https://www.drupal.org/node/2774931',
-      E_USER_DEPRECATED);
-
-      $messenger = \Drupal::messenger();
-      if (isset($message)) {
-          $messenger->addMessage($message, $type, $repeat);
-      }
-      return $messenger->all();
-    }
-
-.. raw:: pdf
-
-    TextAnnotation "drupal_set_message has been replaced by a Messenger service, this should be used instead."
-    TextAnnotation "Works but triggers an error in 8.9, breaks in 9.0."
-    TextAnnotation "To ensure D9 compatibility, update all of the deprecated code."
-
-    PageBreak titlePage
-
-.. class:: centredtitle
-
-How do I find it?
-
-.. raw:: pdf
-
-    PageBreak standardPage
-
-Drupal Check
-============
-
-- Developed by Matt Glaman
-- "Built on PHPStan, this static analysis tool will check for correctness (e.g. using a class that doesn't exist), deprecation errors, and more."
-- https://github.com/mglaman/drupal-check
-
-.. raw:: pdf
-
-    PageBreak titlePage
-
-.. class:: centredtitle
-
-``composer global require
-mglaman/drupal-check``
-
-.. page::
-.. class:: centredtitle
-
-``drupal-check web/modules/custom``
-
-.. raw:: pdf
-
-    PageBreak imagePage
-
-.. image:: images/drupal-check-output.png
-    :width: 22cm
-
-.. raw:: pdf
-
-    PageBreak titlePage
-
-.. class:: centredtitle
-
-Upgrade Status module
-
-.. raw:: pdf
-
-    PageBreak imagePage
-
-.. image:: images/drupal-check-upgrade-status-comparison.png
-    :width: 12cm
-
-.. raw:: pdf
-
-    PageBreak standardPage
-
-PHPUnit Bridge
-==============
-
-- Drupal 8 uses Symfony's PHPUnit Bridge
-- Includes a 'Deprecation Helper'
-- Displays deprecation notices in test output
-
-.. raw:: pdf
-
-    PageBreak imagePage
-
-.. image:: images/phpunit-deprecation.png
-    :width: 23cm
-
-.. raw:: pdf
-
-    PageBreak standardPage
-
-Fixing deprecations
-===================
-
-.. code-block:: diff
-
-    - drupal_set_message($text);
-    + Drupal::messenger()->addMessage($text);
-
-.. image:: images/logo-composer-transparent.png
-    :width: 10cm
-
-Composer
-========
-
-- Dependency management tool for PHP
-- My preferred way to manage Drupal codebases
-- composer.json lists your dependencies and version constraints
-- composer.lock stores the installed dependencies and versions
-- Separate packages for ``core-recommended``, ``core-dev`` and ``core-composer-scaffold``
-
-.. raw:: pdf
-
-    TextAnnotation "Used by the majority of PHP frameworks and projects (Symfony, Laravel, Drush, Drupal Console)."
-
-    PageBreak titlePage
-
-.. class:: centredtitle
-
-``composer require
-drupal/admin_toolbar:^2.0``
-
-.. page::
-.. class:: centredtitle
-
-``composer install``
-
-.. page::
-.. class:: centredtitle
-
-``composer update
-drupal/admin_toolbar``
-
-.. page::
-.. class:: centredtitle
-
-Always add '--no-dev' in production
-
-.. raw:: pdf
-
-    TextAnnotation "Prevents development dependencies from being installed, and potential security exploits from being added."
-    PageBreak titlePage
-
-.. class:: centredtitle
-
-An Example: Dransible
-
-.. class:: centred
-
-https://github.com/opdavies/dransible
-
-.. raw:: pdf
-
-    PageBreak imagePage
-
-.. image:: images/dransible-repo.png
-    :width: 20cm
-
-.. raw:: pdf
-
-    PageBreak standardPage
-
-Upgrading Dransible
-===================
-
-- Remove Drush (temporarily)
-- Update from Drupal 8.8 to 8.9
-- Add Upgrade Status module
-- Update contrib modules to D9 compatible versions
-- Remove incompatible contrib modules (if possible)
-- Fix deprecations in custom code
-- Upgrade from Drupal 8.9 to 9.0
-
-.. raw:: pdf
-
-    TextAnnotation "Without removing Drush, 8.9.0-beta2 rather than 8.9.2"
-    TextAnnotation "Updated Admin Toolbar module to a D9 compatible version"
-    TextAnnotation "Removed Config Installer as no longer needed"
-    TextAnnotation "Fixed deprecation warnings in custom code"
-    TextAnnotation "Installed Drush 10, removed and uninstalled Upgrade Status module"
-
-    PageBreak titlePage
-
-.. class:: centredtitle
-
-``composer update drupal/core-*
---with-dependencies``
-
-.. page::
-.. class:: centredtitle
-
-``composer require
-drupal/upgrade_status``
-
-.. raw:: pdf
-
-    PageBreak imagePage
-
-.. image:: images/dransible-screenshots/1.png
-    :width: 22cm
-
-.. image:: images/dransible-screenshots/2.png
-    :width: 22cm
-
-.. image:: images/dransible-screenshots/3.png
-    :width: 22cm
-
-.. image:: images/dransible-screenshots/4.png
-    :width: 22cm
-
-.. image:: images/dransible-screenshots/5.png
-    :width: 22cm
-
-.. image:: images/dransible-screenshots/6.png
-    :width: 20cm
-
-.. image:: images/dransible-screenshots/7.png
-    :width: 22cm
-
-.. image:: images/dransible-screenshots/8.png
-    :width: 22cm
-
-.. raw:: pdf
-
-    PageBreak titlePage
-
-.. class:: centredtitle
-
-``composer update drupal/core-*
---with-dependencies``
-
-.. raw:: pdf
-
-    PageBreak imagePage
-
-.. image:: images/dransible-screenshots/9.png
-    :width: 22cm
-
-.. image:: images/dransible-screenshots/10.png
-    :width: 20cm
-
-.. raw:: pdf
-
-    TextAnnotation "Only 6 files changed rather than hundreds or thousands"
-    TextAnnotation "Vast majority of the changes in composer.lock (to be expected)"
-    TextAnnotation "Half of the changed files are project specific. Could have been 2 or 3 files changed on some projects."
-
-    PageBreak titlePage
-
-.. class:: centredtitle
-
-There were some autowiring gotchas...
-
-.. raw:: pdf
-
-    PageBreak
-
-``Error: Class 'Symfony\Component\Config\Resource\ClassExistenceResource' not found in Symfony\Component\DependencyInjection\Compiler\AutowirePass->createTypeNotFoundMessage()``
-
-.. page::
-
-.. class:: centredtitle
-
-``composer require
-symfony/config:^4``
-
-.. raw:: pdf
-
-    TextAnnotation "Composer tried installing version 5 by default, so locked to 4.x."
-
-    PageBreak titlePage
-
-``Cannot autowire service "Drupal\simple_message\DisplaySimpleMessage": argument "$messenger" of method "__construct()" references interface "Drupal\Core\Messenger\MessengerInterface" but no such service exists. You should maybe alias this interface to the existing "messenger" service``
-
-.. raw:: pdf
-
-    PageBreak standardPage
-
-Fixing autowiring
-=================
-
-.. code-block:: yaml
-
-    services:
-      Drupal\simple_message\DisplaySimpleMessage:
-        autowire: true
-        tags:
-          - { name: event_subscriber }
-
-Fixing autowiring
-=================
-
-.. code-block:: diff
-
-      services:
-    +   Drupal\Core\Messenger\MessengerInterface:
-    +     alias: messenger
-    +     private: true
-
-        Drupal\simple_message\DisplaySimpleMessage:
-          autowire: true
-          tags:
-            - { name: event_subscriber }
-
-.. raw:: pdf
-
-    PageBreak titlePage
-
-..
-
-    The big deal about Drupal 9 is... that it should not be a big deal
-
-    -- Dries Buytaert
-
-.. raw:: pdf
-
-    TextAnnotation "Dransible updated in 1-2 hours."
-    TextAnnotation "No big rewrite."
-    TextAnnotation "Smallest core update PR ever!"
-
-    PageBreak standardPage
-
-Drupal 10
-=========
-
-- Released around June 2022
-- Drupal 9 EOL around November 2023
-- Symfony 4 EOL in November 2023
-- Another easy upgrade
-
-.. raw:: pdf
-
-    TextAnnotation "Need to keep up to date with dependencies."
-
-Thanks!
-=======
-
-References:
-
-* https://www.drupal.org/docs/understanding-drupal
-* https://dri.es/drupal-9-0-0-released
-* https://dri.es/drupal-10-target-release-date-and-drupal-9-end-of-life
-* https://github.com/opdavies/dransible
-
-|
-
-Me:
-
-* https://www.oliverdavies.uk