[SITE-5350] Add release note for Tika 3.x default change (#9826)

* [SITE-5350] Add release note for Tika 3.x default change

* [SITE-5350] Update Tika docs to reflect new default

* Bump published date

* Fix year, remove drupla category

* Bump date for tika 1 removal

---------

Co-authored-by: Rachel <rachel@pantheon.io>

Author: pwtyler

src/source/content/external-libraries.md

@@ -9,7 +9,7 @@ audience: [development]
 product: [--]
 integration: [--]
 tags: [code, libraries, modules, plugins]
-reviewed: "2025-12-10"
+reviewed: "2026-01-21"
 ---
 
 There are some scenarios when an external library is required. The Pantheon platform includes a number of PHP extensions and common libraries that are available for use.
@@ -49,22 +49,28 @@ Tika can extract content from a number of document formats such as HTML, XML, M
 
 <Tab title="PHP Runtime Generation 2" id="tab-1-anchor" active={true}>
 
-By default, sites using [PHP Runtime Generation 2](/php-runtime-generation-2) have access to Tika 1.18 and 1.21. These versions are available at the following paths:
+New sites created on the Pantheon platform default to Tika 3.x. The Tika 3 jar is available at:
+
+- `/opt/pantheon/tika/tika.jar`
+
+Existing sites may still be using Tika 1.18 or 1.21, which are available at:
 
 - `/srv/bin/tika-app-1.18.jar`
 - `/srv/bin/tika-app-1.21.jar`
 
-Sites that are using these older versions of Tika should be upgraded to a newer version of Tika as soon as possible.
+<Alert title="Tika 1.x End of Life" type="warning">
+
+Tika 1.x will be removed on January 26, 2026. Sites using Tika 1.x should migrate to Tika 3 before this date. See the [Tika 1.x EOL release note](/release-notes/2025/10/tika1x-eol) for details.
 
-Tika 3 is available and recommended. To enable Tika 3, add the following to your `pantheon.yml`:
+</Alert>
+
+To explicitly set your Tika version, add the following to your `pantheon.yml`:
 
 ```yaml:title=pantheon.yml
 tika_version: 3
 ```
 
-Once you have committed the line above, the latest version of Tika 3 will be available at the following path:
-
-- `/opt/pantheon/tika/tika.jar`
+Valid values are `1`, `3`, or `none` (to disable Tika).
 
 </Tab>
 <Tab title="PHP Runtime Generation 1" id="tab-2-id">

src/source/releasenotes/2025-10-14-tika1x-eol.md

@@ -1,14 +1,17 @@
 ---
-title: "Tika 1.xx no longer available starting January 19, 2026"
+title: "Tika 1.xx no longer available starting January 26, 2026"
 published_date: "2025-10-14"
 categories: [infrastructure, action-required, drupal, security]
 ---
-Tika 1.18 and 1.21 will no longer be available starting January 19, 2026. Impacted sites must upgrade to [Tika 3.2](https://tika.apache.org/3.2.0/index.html) which is available via [PHP Runtime Generation 2](/php-runtime-generation-2/).
+
+_**Editorial note: The date has been moved from January 19 to January 26.**_
+
+Tika 1.18 and 1.21 will no longer be available starting January 26, 2026. Impacted sites must upgrade to [Tika 3.2](https://tika.apache.org/3.2.0/index.html) which is available via [PHP Runtime Generation 2](/php-runtime-generation-2/).
 
 The [Apache Tika](https://tika.apache.org/) toolkit detects and extracts metadata and structured text content from various documents using existing parser libraries. On the Pantheon platform, our customers tend to use Tika to parse PDF content for searching with [Solr](/solr).
 
 ## Action Required
 
 For most customers, we expect the upgrade to be seamless and not require any manual intervention. But if your site has a custom Tika integration, we recommend you follow [our documentation for upgrading to Tika 3](/external-libraries#apache-tika) as soon as possible to ensure your site continues to operate as expected.
 
-Sites which have not upgraded to Tika 3 as of January 19, 2026, will be automatically upgraded. Setting `tika_version: 1` in `pantheon.yml` will be ignored after that date. Symlinks from the 1.xx jar filepaths (`/srv/bin/tika-app-1.xx.jar`) will point to the new Tika 3 jar (`/opt/pantheon/tika/tika.jar`). These symlinks will be removed later in 2026.
+Sites which have not upgraded to Tika 3 as of January 26, 2026, will be automatically upgraded. Setting `tika_version: 1` in `pantheon.yml` will be ignored after that date. Symlinks from the 1.xx jar filepaths (`/srv/bin/tika-app-1.xx.jar`) will point to the new Tika 3 jar (`/opt/pantheon/tika/tika.jar`). These symlinks will be removed later in 2026.

src/source/releasenotes/2026-01-21-tika-3-now-default.md

@@ -0,0 +1,24 @@
+---
+title: "Tika 3.x is now the default for new sites"
+published_date: "2026-01-21"
+categories: [infrastructure]
+---
+New sites created on the Pantheon platform now default to Tika 3.x. Previously, new sites defaulted to Tika 1.x.
+
+This change only affects newly created sites. Existing sites will continue to use their current Tika version and are not impacted by this update.
+
+## Overriding the default
+
+If you need to use Tika 1.x for a new site, you can explicitly set the version in your `pantheon.yml` file:
+
+```yaml:title=pantheon.yml
+tika_version: 1
+```
+
+However, [Tika 1.x will be removed on January 26, 2026](/release-notes/2025/10/tika1x-eol). We recommend testing your site with Tika 3.x and migrating before this date.
+
+## More information
+
+- [Apache Tika on Pantheon](/external-libraries#apache-tika)
+- [Tika 3.2 now available](/release-notes/2025/08/tika-3-2-available)
+- [Tika 1.x end of life](/release-notes/2025/10/tika1x-eol)