From cafa4a9190f386c8dcca6fc0e37ed7056c512920 Mon Sep 17 00:00:00 2001
From: Rachel <rachel@pantheon.io>
Date: Wed, 6 Nov 2024 09:01:07 -0600
Subject: [PATCH] D7 LTS Usage and Requirements (#9290)

* Document usage and requirements for D7 lts

* typo

* Apply suggested feed re: switching upstreams

* Copy edits

* Evergreen link to latest drops-7 release

* Add alert setting expectations for d7es

* crosslink tag1

Co-authored-by: Scott Buscemi <scottbuscemi@users.noreply.github.com>

* copy edit

Co-authored-by: Scott Buscemi <scottbuscemi@users.noreply.github.com>

* copy edit

Co-authored-by: Scott Buscemi <scottbuscemi@users.noreply.github.com>

* copy edit

Co-authored-by: Scott Buscemi <scottbuscemi@users.noreply.github.com>

* Update source/content/supported-drupal.md

Co-authored-by: Scott Buscemi <scottbuscemi@users.noreply.github.com>

* Referral copy edit

* contrib updates for non-sandbox or paid workspaces

Co-authored-by: Scott Buscemi <scottbuscemi@users.noreply.github.com>

---------

Co-authored-by: Scott Buscemi <scottbuscemi@users.noreply.github.com>
---
 source/content/supported-drupal.md | 91 +++++++++++++++++++++++++++---
 1 file changed, 83 insertions(+), 8 deletions(-)

diff --git a/source/content/supported-drupal.md b/source/content/supported-drupal.md
index bbd8962f5f..562953c915 100644
--- a/source/content/supported-drupal.md
+++ b/source/content/supported-drupal.md
@@ -10,7 +10,7 @@ cms: [drupal]
 audience: [development]
 product: [--]
 integration: [--]
-reviewed: "2024-10-15"
+reviewed: "2024-11-04"
 ---
 
 The following table indicates availability of the specified Drupal versions, as well as our usage recommendations and our support scope.
@@ -40,16 +40,91 @@ terminus site:create <site> <label> drupal8
 Refer to [Create a New CMS Site](/add-site-dashboard) for how to create a new Drupal 7 site from the Pantheon dashboard.
 
 ### Drupal 7 long-term support
-Drupal 7 will reach it's end of life on January 5, 2025. Pantheon has partnered with Tag1 Consulting to offer Long-Term Support for Drupal 7 through January 5, 2027.
+Drupal 7 will reach it's end of life on January 5, 2025. Pantheon has partnered with [Tag1 Consulting](https://www.tag1consulting.com/) to offer Long-Term Support for Drupal 7 through **January 5, 2027**.
+To learn more about this partnership, see the [related blog post](https://pantheon.io/blog/pantheon-and-tag1-support-drupal-7-websites).
 
-#### What's included
-* Security and compatibility updates to Drupal core and core dependencies from Tag1 Consulting by updating their site running on the [Pantheon Drupal 7 Upstream](https://github.com/pantheon-systems/drops-7) via [the Pantheon Dashboard](core-updates#apply-upstream-updates-via-the-site-dashboard) or [Terminus command line tool](/core-updates#apply-upstream-updates-via-terminus).
-* Security patches and compatibility updates to community-contributed modules that power their site via Tag1’s D7 Extended Support (D7ES) module, which will be included in the Upstream.
-* Continued support for Drupal 7-compatible runtime environments on the Pantheon Platform, including PHP, MySQL and other prerequisites.
 
-To learn more about this partnership, see related blog post: [Pantheon and Tag1 Consulting Partner to Provide Long-Term Support for Drupal 7 Websites ](https://pantheon.io/blog/pantheon-and-tag1-support-drupal-7-websites).
+#### D7 Core LTS and Platform Compatibility 
+The D7 Long-Term Support includes security and compatibility updates to Drupal core and core dependencies from Tag1 Consulting, which are distributed by the Pantheon Drupal 7 Upstream and made available as a one-click updates via [the Pantheon Dashboard](core-updates#apply-upstream-updates-via-the-site-dashboard) or [Terminus command line tool](/core-updates#apply-upstream-updates-via-terminus).
+
+Also included is continued support for Drupal 7-compatible runtime environments on the Pantheon Platform, including PHP, MySQL and other prerequisites.
+
+##### Requirements
+* Available to all site plans and workspace tiers.
+* Sites must use the [Pantheon Drupal 7 Upstream](https://github.com/pantheon-systems/drops-7).
+  * Or a Custom Upstream based on the Pantheon Drupal 7 Upstream with the [latest updates pulled in](/guides/custom-upstream/create-custom-upstream#pull-in-core-from-pantheons-upstream).
+* Sites must be updated to the [latest release](https://github.com/pantheon-systems/drops-7/tags) of Drupal core.
+<br/>
+<br/>
+
+To verify your current Drupal core version, you can check the [Status report tab](/drupal-launch-check#status-report) in the Pantheon site dashboard or you can use Terminus: 
+
+```bash{promptUser: user}
+terminus drush <site>.<env> status
+```
+
+To verify your current upstream, you can go to the Pantheon site dashboard and click **Settings**, then **About Site** or you can use Terminus: 
+
+```bash{promptUser: user}
+terminus site:info <site>
+```
+
+For sites not already using the Pantheon Drupal 7 Upstream (or a Custom Upstream based on the Pantheon Drupal 7 Upstream), Pantheon partners with experienced web development agencies. Use our [Agency Matchmaker](https://directory.pantheon.io/agencies/matchmaking?utm_medium=email&utm_source=nurture&utm_content=agency_directory_match_maker&utm_campaign=2024_7_NU_WCOMP_US_wp_compete) to be connected with a trusted expert.
+
+#### D7 Contrib Modules LTS
+This includes security patches and compatibility updates to community-contributed modules via Tag1’s [D7 Extended Support (D7ES) module](https://www.drupal.org/project/tag1_d7es), which will be distributed and maintained as part of the Pantheon Drupal 7 Upstream.
+
+##### Requirements
+* Available to all non-Sandbox site plans, or sites associated with a Gold, Diamond, or Platinum [workspace account tier](/guides/account-mgmt/plans/workspace-plans).
+* Sites must use the [Pantheon Drupal 7 Upstream](https://github.com/pantheon-systems/drops-7).
+  * Or a Custom Upstream based on the Pantheon Drupal 7 Upstream with the [latest updates pulled in](/guides/custom-upstream/create-custom-upstream#pull-in-core-from-pantheons-upstream).
+* Sites must be updated to the [latest release](https://github.com/pantheon-systems/drops-7/tags) of Drupal core.
+* (Recommended) Not a requirement, but we strongly recommend updating all contrib modules to their latest versions as well. 
+
+##### D7ES Usage
+<Alert title="Note" type="info" >
+
+This usage section is not yet applicable as the D7ES module has not been added to the Pantheon Drupal 7 Upstream.
+
+However, you can expect the functionality and behavior described below to become available in the near future, before Drupal 7's end of life date.
+</Alert>
+
+By enabling this module and configuring the opt-in, your site’s list of contrib modules will be automatically submitted for D7ES security coverage. You will receive email notifications of D7 core & installed contrib module security and compatibility updates. 
+
+Enable the module, then go to `/admin/config/system/tag1-d7es` and configure the list of email addresses that should be notified when applicable updates are released. On this configuration page you can also confirm your sites connection with Tag1’s update servers.
+
+Apply contrib updates from the Tag1 D7ES service via Drush, Autopilot, or manually via SFTP. For details, see the following tabs.
+
+<TabList>
+
+<Tab title="Drush (Recommended)" id="drush" active={true}>
+
+1. [Set the connection mode to SFTP](/guides/sftp) for the Dev or Multidev environment via the Pantheon Dashboard or with [Terminus](/terminus):
+
+ ```bash{promptUser: user}
+ terminus connection:set <site>.<env> sftp
+ ```
+
+1. Use Drush to apply contrib updates from the Tag1 D7ES service: 
+ ```bash{promptUser: user}
+ terminus drush <site>.<env> pm:update --no-core
+ ```
+
+</Tab>
+
+<Tab title="Autopilot (Recommended)" id="autopilot">
+
+[Autopilot](/guides/autopilot) will automatically apply contrib module updates from the Tag1 D7ES service the next time Autopilot runs.
+ 
+</Tab>
+<Tab title="Manual Overwrite" id="overwrite">
+
+The notification email will include the fully updated module package in tarball (tar.gz) and ZIP archive formats, along with a text patch file of the change. You can update contrib modules by unpackaging and replacing the entire module folder via your preferred SFTP client. For details, see [SFTP Access and Authentication](/guides/sftp/sftp-connection-info).
+
+</Tab>
+
+</TabList>
 
-To learn more about migrating from Drupal 7 to the latest version of Drupal, see [this guide](https://pantheon.io/resources/guide/drupal-7-end-life-why-you-should-start-your-migration-drupal-10-today).
 
 ## Drush version support