From 58ab228a7c352cb10b3951bdb8e421e748469340 Mon Sep 17 00:00:00 2001
From: Ivan Bochkarev <ivanx86@gmail.com>
Date: Sat, 15 Aug 2026 23:04:58 +0600
Subject: [PATCH 1/2] =?UTF-8?q?docs(upgrading):=20Add=202.4=E2=80=932.8=20?=
 =?UTF-8?q?upgrade=20notes=20(en+ru)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Fill the missing minor-version upgrade pages for Revolution 2.x and link the full series from the upgrading index. Based on changelog highlights and release posts; closes the gap left by empty stubs in #287.
---
 en/getting-started/maintenance/upgrading.md   | 33 ++++++----
 .../maintenance/upgrading/2.4.md              | 55 ++++++++++++++++
 .../maintenance/upgrading/2.5.md              | 44 +++++++++++++
 .../maintenance/upgrading/2.6.md              | 46 ++++++++++++++
 .../maintenance/upgrading/2.7.md              | 55 ++++++++++++++++
 .../maintenance/upgrading/2.8.md              | 61 ++++++++++++++++++
 ru/getting-started/maintenance/upgrading.md   | 37 ++++++-----
 .../maintenance/upgrading/2.4.md              | 56 +++++++++++++++++
 .../maintenance/upgrading/2.5.md              | 45 ++++++++++++++
 .../maintenance/upgrading/2.6.md              | 47 ++++++++++++++
 .../maintenance/upgrading/2.7.md              | 56 +++++++++++++++++
 .../maintenance/upgrading/2.8.md              | 62 +++++++++++++++++++
 12 files changed, 571 insertions(+), 26 deletions(-)
 create mode 100644 en/getting-started/maintenance/upgrading/2.4.md
 create mode 100644 en/getting-started/maintenance/upgrading/2.5.md
 create mode 100644 en/getting-started/maintenance/upgrading/2.6.md
 create mode 100644 en/getting-started/maintenance/upgrading/2.7.md
 create mode 100644 en/getting-started/maintenance/upgrading/2.8.md
 create mode 100644 ru/getting-started/maintenance/upgrading/2.4.md
 create mode 100644 ru/getting-started/maintenance/upgrading/2.5.md
 create mode 100644 ru/getting-started/maintenance/upgrading/2.6.md
 create mode 100644 ru/getting-started/maintenance/upgrading/2.7.md
 create mode 100644 ru/getting-started/maintenance/upgrading/2.8.md

diff --git a/en/getting-started/maintenance/upgrading.md b/en/getting-started/maintenance/upgrading.md
index 0e292e0c1..cbe1357b3 100644
--- a/en/getting-started/maintenance/upgrading.md
+++ b/en/getting-started/maintenance/upgrading.md
@@ -66,12 +66,16 @@ It's a good idea to clear your browser cache after upgrading. Browsers often cac
 
 For changes relating to specific versions, please see the following pages:
 
-- [For Upgrading to 2.2](getting-started/maintenance/upgrading/2.2 "Upgrading to 2.2.x")
-- [For Upgrading From 2.0.x to 2.1.x](getting-started/maintenance/upgrading/2.1 "Upgrading from 2.0.x to 2.1.x") **!important**
-- [For Upgrades Coming From Prior to 2.0.5](getting-started/maintenance/upgrading/2.0.5 "Upgrading from Versions Earlier than 2.0.5")
-- [For Upgrades Coming From Prior to 2.0.0-rc2](getting-started/maintenance/upgrading/2.0.0-rc2 "Upgrading to Revolution 2.0.0-rc-2")
-
-Upgrades after 2.0.0-rc-2 should run smoothly without issues.
+- [Upgrading to 2.8](getting-started/maintenance/upgrading/2.8), then the security-related changes in [2.8.2 / 2.8.3](getting-started/maintenance/upgrading/2.8.2)
+- [Upgrading to 2.7](getting-started/maintenance/upgrading/2.7)
+- [Upgrading to 2.6](getting-started/maintenance/upgrading/2.6)
+- [Upgrading to 2.5](getting-started/maintenance/upgrading/2.5)
+- [Upgrading to 2.4](getting-started/maintenance/upgrading/2.4)
+- [Upgrading to 2.3](getting-started/maintenance/upgrading/2.3)
+- [Upgrading to 2.2](getting-started/maintenance/upgrading/2.2)
+- [Upgrading from 2.0.x to 2.1.x](getting-started/maintenance/upgrading/2.1) **!important**
+- [Upgrades from prior to 2.0.5](getting-started/maintenance/upgrading/2.0.5)
+- [Upgrades from prior to 2.0.0-rc2](getting-started/maintenance/upgrading/2.0.0-rc2)
 
 ## See Also
 
@@ -96,9 +100,14 @@ See the note above about FTP clients that support directory merging.
 ### Related Articles
 
 1. [Troubleshooting Upgrades](getting-started/maintenance/upgrading/troubleshooting)
-2. [Upgrading to 2.2.x](getting-started/maintenance/upgrading/2.2)
-3. [Upgrading from 2.0.x to 2.1.x](getting-started/maintenance/upgrading/2.1)
-4. [Upgrading from Versions Earlier than 2.0.5](getting-started/maintenance/upgrading/2.0.5)
-5. [Upgrading to Revolution 2.0.0-rc-2](getting-started/maintenance/upgrading/2.0.0-rc2)
-6. [Upgrading from MODX Evolution](getting-started/maintenance/upgrading/evolution)
-7. [Functional Changes from Evolution](getting-started/maintenance/upgrading/evolution/functional-changes)
+2. [Upgrading to 2.8](getting-started/maintenance/upgrading/2.8)
+3. [Upgrading to 2.8.2 / 2.8.3](getting-started/maintenance/upgrading/2.8.2)
+4. [Upgrading to 2.7](getting-started/maintenance/upgrading/2.7)
+5. [Upgrading to 2.6](getting-started/maintenance/upgrading/2.6)
+6. [Upgrading to 2.5](getting-started/maintenance/upgrading/2.5)
+7. [Upgrading to 2.4](getting-started/maintenance/upgrading/2.4)
+8. [Upgrading to 2.3](getting-started/maintenance/upgrading/2.3)
+9. [Upgrading to 2.2.x](getting-started/maintenance/upgrading/2.2)
+10. [Upgrading from 2.0.x to 2.1.x](getting-started/maintenance/upgrading/2.1)
+11. [Upgrading from MODX Evolution](getting-started/maintenance/upgrading/evolution)
+12. [Functional Changes from Evolution](getting-started/maintenance/upgrading/evolution/functional-changes)
diff --git a/en/getting-started/maintenance/upgrading/2.4.md b/en/getting-started/maintenance/upgrading/2.4.md
new file mode 100644
index 000000000..b85b610bf
--- /dev/null
+++ b/en/getting-started/maintenance/upgrading/2.4.md
@@ -0,0 +1,55 @@
+---
+title: "Upgrading to 2.4"
+sortorder: 95
+---
+
+MODX Revolution 2.4.0 (August 2015) adds package dependencies, namespace permissions, database indexes, and manager improvements. Use this page when you move onto the 2.4 line. For the full ticket list, see [`core/docs/changelog.txt`](https://github.com/modxcms/revolution/blob/2.x/core/docs/changelog.txt).
+
+Release overviews:
+
+- [Revolution 2.4 — Package Dependencies & More](https://modx.com/blog/2015/08/19/revolution-2.4/)
+- [Deep Dive Into MODX Revolution 2.4](https://modx.com/blog/2015/08/26/deep-dive-into-modx-revolution-2.4/)
+
+## Before you upgrade
+
+- Upgrade to the latest 2.4 patch release, rather than stopping at 2.4.0. The 2.4 line includes the security fix from 2.3.6.
+- Update Extras on the current version, clear `core/cache`, flush sessions, and back up the database and files.
+- Check custom integrations with `modTransportProvider`. MODX 2.4.1 restored compatibility for Extras that used its previous behaviour.
+
+## Changes to review
+
+### User profile country values
+
+`modUserProfile.country` stores ISO country codes instead of translated country names. Check imports, exports, profile forms, and reports that compare this field with a full country name.
+
+### Resource URI generation
+
+The `use_frozen_parent_uris` setting lets child URI generation respect frozen parent URIs. Review generated aliases if your site freezes resource URIs or builds paths in custom code.
+
+### Access control and namespaces
+
+2.4 adds namespace permissions and combines the user-group tree with a user grid in the ACL page. Re-test custom access policies and manager users after setup.
+
+### Package dependencies
+
+Transport packages can declare dependencies on other Extras. Package Manager resolves those dependencies and may show setup options during installation. Test packages with custom resolvers or setup-option windows.
+
+## Other notable additions
+
+- New database indexes for common queries.
+- System Events management page.
+- Real-time resource alias generation.
+- Regular-expression validation for text TVs.
+- Date TVs can hide the time input.
+- Custom icons for media sources and contexts.
+- New `saveObject` and `removeObject` methods in object processors.
+- JSONP support in `modConnectorResponse`.
+- `contentType=string` support in `modRestCurlClient`.
+
+## Patch-level caution
+
+2.4.3 introduced a regression in output filters on undefined placeholders. MODX 2.4.4 fixed it. Install the latest 2.4.x patch and test pages that apply output modifiers to missing values.
+
+## After setup
+
+Check manager login, ACLs, Package Manager dependency resolution, user profile country values, and friendly URLs. Clear the manager browser cache before testing.
diff --git a/en/getting-started/maintenance/upgrading/2.5.md b/en/getting-started/maintenance/upgrading/2.5.md
new file mode 100644
index 000000000..c5bb2bcca
--- /dev/null
+++ b/en/getting-started/maintenance/upgrading/2.5.md
@@ -0,0 +1,44 @@
+---
+title: "Upgrading to 2.5"
+sortorder: 93
+---
+
+MODX Revolution 2.5.0 (April 2016) focused on PHP 7 readiness, manager usability, and anonymous-request performance. Use this page when you move a site onto the 2.5 line. For the full list of tickets, see [`core/docs/changelog.txt`](https://github.com/modxcms/revolution/blob/2.x/core/docs/changelog.txt) in the Revolution repo.
+
+Release overview: [MODX Revolution 2.5—PHP 7, Performance and More](https://modx.com/blog/2016/04/21/modx-revolution-2.5/).
+
+## Before you upgrade
+
+- Confirm the host can run PHP 5.3+ for 2.5.x. Prefer PHP 7 if the host offers it. PHP 7 support landed in this line (`modPhpThumb` and related fixes).
+- Update Extras on the current version first, then clear `core/cache` and flush sessions before setup.
+
+## Things that change behaviour
+
+### `anonymous_sessions`
+
+2.5 adds the [`anonymous_sessions`](building-sites/settings/anonymous_sessions) setting so anonymous front-end hits can skip PHP sessions.
+
+- Default is Yes (sessions for anonymous users still exist unless you change it).
+- Set it to No only as a **context** setting on a front-end context that does not need sessions. Putting No in System Settings can lock you out of the manager.
+
+### Manager JS/CSS compression
+
+`compress_js` no longer builds minified manager assets on the fly. The core ships prebuilt `min.js` / CSS bundles instead. That removes a common source of broken managers after minifier failures. Site developers who patch core manager assets must rebuild those bundles; normal upgrades do not need extra steps.
+
+### Upgrade cleanup
+
+Setup removes selected legacy core files during upgrade. Keep a backup of the tree before you run setup so you can compare if a custom patch lived in a removed path.
+
+## Notable additions (no forced config change)
+
+- More mobile-friendly manager layout and login accessibility work.
+- New default manager template / starter content for fresh installs.
+- Output filters `stripmodxtags` and `htmlspecial`.
+- Zip unpack in the media/file tree.
+- `modParsedManagerController` for CMPs that use snippets and chunks.
+- Uberbar can search by resource ID.
+- Smarty and PHPMailer library updates (Smarty BC restored in 2.5.0-rc2).
+
+## After setup
+
+Clear the browser cache for the manager domain so you load the new static asset bundles. Re-test login, Package Manager, and any Extra that hooks manager JS.
diff --git a/en/getting-started/maintenance/upgrading/2.6.md b/en/getting-started/maintenance/upgrading/2.6.md
new file mode 100644
index 000000000..6db55638d
--- /dev/null
+++ b/en/getting-started/maintenance/upgrading/2.6.md
@@ -0,0 +1,46 @@
+---
+title: "Upgrading to 2.6"
+sortorder: 92
+---
+
+MODX Revolution 2.6.0 (November 2017) is a large stability and manager UX release. Use this page when you move onto the 2.6 line. Full ticket list: [`core/docs/changelog.txt`](https://github.com/modxcms/revolution/blob/2.x/core/docs/changelog.txt).
+
+Release overview: [A Major New Milestone for MODX Revolution](https://modx.com/blog/modx-revolution-2-6).
+
+## Before you upgrade
+
+- Prefer 2.5.8 (or later 2.5.x) as the jump-off point when you can. Older 2.x sites still upgrade, but Extras and custom code need more smoke-testing.
+- Update packages, clear `core/cache`, flush sessions, then run setup.
+
+## Database notes
+
+### InnoDB on new installs
+
+New MySQL installs create tables with the **InnoDB** engine when the server supports it. Existing MyISAM sites keep their current engines after upgrade. You can convert later if you want InnoDB benefits. See [How to change your MyISAM DB to InnoDB using phpMyAdmin](https://modx.com/blog/convert-myisam-to-innodb-with-phpmyadmin).
+
+### utf8mb4 indexes
+
+Index prefixes on `varchar` / `text` columns were shortened so MySQL can use **utf8mb4**. That mainly matters for new installs and for hosts that already use utf8mb4. If you change collation manually after upgrade, check index lengths against MySQL limits.
+
+## Behaviour and security to verify
+
+- **TV `@EVAL` binding:** set [`allow_tv_eval`](building-sites/settings/allow_tv_eval) to No to disable EVAL bindings (`#13224`). Turn it off on production if you do not need it.
+- **Cached vs uncached tags:** processing of non-cacheable elements inside cacheable ones was fixed (`#13530`). Re-check pages that mix `!` tags inside cached chunks/snippets.
+- **`failed_login_attempts`:** the setting is honoured again (`#13516`). Confirm lockout behaviour matches what you expect.
+- **PHP 7:** session callback and related PHP 7 errors in this line were addressed. Still run a manager login and a front-end session smoke test on PHP 7 hosts.
+- Package install / uninstall / remove fire new events (`#12936`). Custom plugins that assume the old event set should be reviewed.
+
+## Notable manager and API additions
+
+- Who's Online dashboard widget.
+- SVG previews in the Media Browser.
+- Custom manager top menus (`#12554`).
+- `OnResourceCacheUpdate` event for third-party cache layers.
+- Option to skip resource duplication when duplicating a context.
+- `.less`, `.scss`, `.sass`, and `.css.map` among default allowed upload types.
+- DKIM-related PHPMailer attributes.
+- REST: `OPTIONS` on `modRestController`, stream upload support for binary files.
+
+## After setup
+
+Clear manager browser cache. Spot-check Package Manager, media uploads, user login lockout, and any dashboard widgets. On MyISAM hosts, plan an InnoDB conversion only after a full database backup.
diff --git a/en/getting-started/maintenance/upgrading/2.7.md b/en/getting-started/maintenance/upgrading/2.7.md
new file mode 100644
index 000000000..2c2bb7579
--- /dev/null
+++ b/en/getting-started/maintenance/upgrading/2.7.md
@@ -0,0 +1,55 @@
+---
+title: "Upgrading to 2.7"
+sortorder: 91
+---
+
+MODX Revolution 2.7.0 (November 2018) adds Trash Manager, native password hashing, static-element automation, and several Media Browser hardenings. Use this page when you move onto the 2.7 line. Full ticket list: [`core/docs/changelog.txt`](https://github.com/modxcms/revolution/blob/2.x/core/docs/changelog.txt).
+
+Release overview: [Revolution 2.7: An Impressive and Feature-Packed Release](https://modx.com/blog/modx-revolution-2.7).
+
+## Before you upgrade
+
+- Merge **all** core files from the release package. Incomplete uploads (especially under `core/docs/` and setup templates) have produced broken `config.inc.php` writes when obsolete keys like `cache_disabled` disappeared from the templates.
+- Keep a copy of `core/config/config.inc.php` before setup. If setup writes unresolved `{placeholders}` into that file, restore the backup and run setup again with a complete file tree.
+- Update Extras, clear `core/cache`, flush sessions.
+
+## Breaking / high-impact changes
+
+### Removed settings
+
+2.7 removes the non-functional `cache_disabled` system setting and drops `cache_system_settings` from system settings. Do not reintroduce those keys by hand. If an old deploy script or Extra still writes them, clean that up after upgrade.
+
+### Password hashing
+
+User passwords use **native PHP password hashing** (`#13926`). Existing hashes keep working through the normal login upgrade path. Custom user-import or password-reset scripts that assume plain MD5 need to follow the current hash class / `hash_class` behaviour instead of writing raw MD5 into `modUser`.
+
+### Deprecated 0.9.x parser utilities
+
+Migration helpers aimed at the old 0.9.x parser are deprecated and logged for removal in 3.0 (`#14131`). Finish any leftover migration work before you jump to MODX 3.
+
+### Media Browser and paths
+
+- Invalid relative media source paths no longer expose filesystem roots (`#14038`).
+- Clearing `modFileRegister` no longer deletes arbitrary paths (`#13980`).
+- phpThumb receives filtered user parameters (`#13979`).
+
+Re-test custom media sources that rely on unusual relative bases.
+
+## Features worth configuring after upgrade
+
+- **Trash Manager** for restore / purge of deleted resources (`#14058`).
+- **Automatic static elements** workflow (`#14135`) if you keep elements on disk.
+- **`automatic_template_assignment`** (`#13700`).
+- Resource option **Use current alias in alias path** to omit a resource segment from the URI (`#11153`).
+- **`set_sudo`** permission (`#13807`) for controlled sudo elevation.
+- **Purge Old Versions** in Package Management (`#12818`).
+- Composer-oriented project install plus **CLI setup** script (`#13790`).
+- Customisable error.log location (`#13768`) and configurable custom error handler class path (`#14119`).
+- Output filter `filterPathSegment` (`#13699`).
+- Form Customization wildcards on actions (`#13775`).
+
+## After setup
+
+Confirm manager login (password hash path), Trash Manager, Media Browser sources, and Package Manager purge. If `config.inc.php` looks wrong, restore the pre-upgrade file and re-run setup with a complete 2.7 tree.
+
+If you later move to MODX 3, finish anything that still depends on the deprecated 0.9.x utilities first. See the [MODX 3 upgrade guide](https://docs.modx.com/3.x/en/getting-started/upgrading-to-3.0).
diff --git a/en/getting-started/maintenance/upgrading/2.8.md b/en/getting-started/maintenance/upgrading/2.8.md
new file mode 100644
index 000000000..ad4b2682d
--- /dev/null
+++ b/en/getting-started/maintenance/upgrading/2.8.md
@@ -0,0 +1,61 @@
+---
+title: "Upgrading to 2.8"
+sortorder: 89
+---
+
+MODX Revolution 2.8.0 (October 2020) focuses on manager security, file handling, and library updates. Use this page when you enter the 2.8 line. Continue with [the 2.8.2 / 2.8.3 notes](getting-started/maintenance/upgrading/2.8.2) before installing a later 2.8 release.
+
+Release overview: [MODX Revolution 2.8](https://modx.com/blog/modx-revolution-2.8).
+
+## Before you upgrade
+
+- Install the latest 2.8.x patch available. Do not stop at 2.8.0.
+- Update Extras, clear `core/cache`, flush sessions, and back up the database and files.
+- Merge the complete release tree before setup. 2.8.0 fixes a fatal error when upgrading from 2.5.x or earlier, but setup still needs every current core file.
+- List the media sources available to each limited manager user. The new permission checks may remove file access that the user previously had by mistake.
+
+## Security and permissions
+
+2.8.0 closes several manager-side stored XSS issues and hardens file operations:
+
+- Limited manager users can only interact with files in media sources they can access.
+- File upload and file-tree values receive stronger XSS protection.
+- `modRestService` blocks a potential XXE path.
+- Registry messages block path traversal.
+- Template names are escaped in template and TV access grids.
+
+These fixes affect authenticated manager users. Re-test custom manager pages, file browsers, and ACLs with a non-administrator account.
+
+## File and image handling
+
+- `webp` joins the default uploadable file and image types.
+- Upload handling checks whether a file already exists and fixes path selection.
+- The login screen gets responsive styles.
+- phpThumb is updated to 1.7.15.
+
+If you maintain a custom upload allowlist, add `webp` only when the server and your image pipeline support it.
+
+## Template Variables and settings
+
+- URL, RichText, Image, and File TVs gain an **Allow Blank** option.
+- Listbox (Multi-Select) TVs can accept custom values.
+- System Settings gain a number field type.
+
+Review validation for TVs where an empty value must remain forbidden. The new option makes that rule explicit.
+
+## Library updates
+
+2.8.0 updates:
+
+- xPDO to 2.8.1
+- Smarty to 3.1.36
+- PHPMailer to 5.2.28
+- phpThumb to 1.7.15
+
+Test custom Smarty plugins, mail integrations, and image processing after setup.
+
+## After setup
+
+Log in as an administrator and as each limited manager role. Check media source access, uploads, TV validation, resource trash, email delivery, and manager pages supplied by Extras.
+
+Before moving past 2.8.1, read [Upgrading to 2.8.2 and 2.8.3](getting-started/maintenance/upgrading/2.8.2). Those releases tighten static-resource paths and permissions and may require configuration changes.
diff --git a/ru/getting-started/maintenance/upgrading.md b/ru/getting-started/maintenance/upgrading.md
index 510ec7a8f..3d78c508d 100644
--- a/ru/getting-started/maintenance/upgrading.md
+++ b/ru/getting-started/maintenance/upgrading.md
@@ -63,14 +63,18 @@ translation: "getting-started/maintenance/upgrading"
 
 ## Изменения в зависимости от версии
 
- Для обновлений, касающихся определенных версий, пожалуйста ознакомьтесь со следующими страницами:
-
-- [Обновление до версии 2.2](getting-started/maintenance/upgrading/2.2 "Обновление до 2.2.x")
-- [Обновление с версии 2.0.x до 2.1.x](getting-started/maintenance/upgrading/2.1 "Обновление с версии 2.0.x до 2.1.x") **!важно**
-- [Обновление с более ранних версий до 2.0.5](getting-started/maintenance/upgrading/2.0.5 "Обновление с более ранних версий до 2.0.5")
-- [Обновление до версии MODX Revolution 2.0.0-rc-2](getting-started/maintenance/upgrading/2.0.0-rc2 "Обновление до версии MODX Revolution 2.0.0-rc-2")
-
- Обновления после 2.0.0-rc-2 должны выполняться без проблем.
+Для изменений по конкретным версиям см. страницы:
+
+- [Обновление до 2.8](getting-started/maintenance/upgrading/2.8), затем изменения безопасности в [2.8.2 / 2.8.3](getting-started/maintenance/upgrading/2.8.2)
+- [Обновление до 2.7](getting-started/maintenance/upgrading/2.7)
+- [Обновление до 2.6](getting-started/maintenance/upgrading/2.6)
+- [Обновление до 2.5](getting-started/maintenance/upgrading/2.5)
+- [Обновление до 2.4](getting-started/maintenance/upgrading/2.4)
+- [Обновление до 2.3](getting-started/maintenance/upgrading/2.3)
+- [Обновление до 2.2](getting-started/maintenance/upgrading/2.2)
+- [Обновление с 2.0.x до 2.1.x](getting-started/maintenance/upgrading/2.1) **!важно**
+- [Обновление с версий до 2.0.5](getting-started/maintenance/upgrading/2.0.5)
+- [Обновление с версий до 2.0.0-rc2](getting-started/maintenance/upgrading/2.0.0-rc2)
 
 ## Смотри также
 
@@ -95,9 +99,14 @@ cp -fr modx-2.2.0-pl/* /www/public_html/modx
 ### Смотрите также
 
 1. [Решение проблем с обновлением](getting-started/maintenance/upgrading/troubleshooting)
-2. [Обновление до версии 2.2.x](getting-started/maintenance/upgrading/2.2)
-3. [Обновление с версии 2.0.x до 2.1.x](getting-started/maintenance/upgrading/2.1)
-4. [Обновление с более ранних версий до 2.0.5](getting-started/maintenance/upgrading/2.0.5)
-5. [Обновление до версии MODX Revolution 2.0.0-rc-2](getting-started/maintenance/upgrading/2.0.0-rc2)
-6. [Обновление с MODX Evolution](getting-started/maintenance/upgrading/evolution)
-7. [Функциональные отличия от Evolution](getting-started/maintenance/upgrading/evolution/functional-changes)
+2. [Обновление до 2.8](getting-started/maintenance/upgrading/2.8)
+3. [Обновление до 2.8.2 / 2.8.3](getting-started/maintenance/upgrading/2.8.2)
+4. [Обновление до 2.7](getting-started/maintenance/upgrading/2.7)
+5. [Обновление до 2.6](getting-started/maintenance/upgrading/2.6)
+6. [Обновление до 2.5](getting-started/maintenance/upgrading/2.5)
+7. [Обновление до 2.4](getting-started/maintenance/upgrading/2.4)
+8. [Обновление до 2.3](getting-started/maintenance/upgrading/2.3)
+9. [Обновление до 2.2.x](getting-started/maintenance/upgrading/2.2)
+10. [Обновление с 2.0.x до 2.1.x](getting-started/maintenance/upgrading/2.1)
+11. [Обновление с MODX Evolution](getting-started/maintenance/upgrading/evolution)
+12. [Функциональные отличия от Evolution](getting-started/maintenance/upgrading/evolution/functional-changes)
diff --git a/ru/getting-started/maintenance/upgrading/2.4.md b/ru/getting-started/maintenance/upgrading/2.4.md
new file mode 100644
index 000000000..e33ea088d
--- /dev/null
+++ b/ru/getting-started/maintenance/upgrading/2.4.md
@@ -0,0 +1,56 @@
+---
+title: "Обновление до 2.4"
+translation: "getting-started/maintenance/upgrading/2.4"
+sortorder: 95
+---
+
+MODX Revolution 2.4.0 (август 2015) добавляет зависимости пакетов, права пространств имён, индексы базы данных и улучшения менеджера. Используйте эту страницу при переходе на линейку 2.4. Полный список тикетов находится в [`core/docs/changelog.txt`](https://github.com/modxcms/revolution/blob/2.x/core/docs/changelog.txt).
+
+Обзоры релиза:
+
+- [Revolution 2.4 — Package Dependencies & More](https://modx.com/blog/2015/08/19/revolution-2.4/)
+- [Deep Dive Into MODX Revolution 2.4](https://modx.com/blog/2015/08/26/deep-dive-into-modx-revolution-2.4/)
+
+## Перед обновлением
+
+- Ставьте последний патч 2.4, а не 2.4.0. В линейку 2.4 входит исправление безопасности из 2.3.6.
+- Обновите Extras на текущей версии, очистите `core/cache`, сбросьте сессии и сделайте резервные копии базы данных и файлов.
+- Проверьте интеграции с `modTransportProvider`. MODX 2.4.1 вернул совместимость с Extras, которые зависели от прежнего поведения.
+
+## Что проверить
+
+### Страна в профиле пользователя
+
+`modUserProfile.country` хранит код страны ISO вместо переведённого названия. Проверьте импорт, экспорт, формы профиля и отчёты, которые сравнивают это поле с полным названием страны.
+
+### Формирование URI ресурсов
+
+Настройка `use_frozen_parent_uris` позволяет учитывать зафиксированные URI родителей при построении URI дочерних ресурсов. Проверьте адреса, если сайт фиксирует URI ресурсов или формирует пути в своём коде.
+
+### Контроль доступа и пространства имён
+
+В 2.4 появились права пространств имён, а дерево групп пользователей объединили с таблицей пользователей на странице ACL. После setup проверьте свои политики доступа и учётные записи менеджера.
+
+### Зависимости пакетов
+
+Транспортные пакеты могут объявлять зависимости от других Extras. Package Manager разрешает эти зависимости и может показывать параметры setup при установке. Проверьте пакеты со своими резолверами и окнами параметров.
+
+## Другие заметные изменения
+
+- Новые индексы базы данных для частых запросов.
+- Страница управления системными событиями.
+- Формирование alias ресурса в реальном времени.
+- Проверка текстовых TV по регулярному выражению.
+- Возможность скрыть время в TV с датой.
+- Свои иконки для media source и контекстов.
+- Методы `saveObject` и `removeObject` в процессорах объектов.
+- Поддержка JSONP в `modConnectorResponse`.
+- Поддержка `contentType=string` в `modRestCurlClient`.
+
+## Предупреждение о патчах
+
+В 2.4.3 появилась регрессия выходных фильтров на неопределённых плейсхолдерах. MODX 2.4.4 исправил её. Ставьте последний патч 2.4.x и проверьте страницы, где выходные модификаторы применяются к отсутствующим значениям.
+
+## После setup
+
+Проверьте вход в менеджер, ACL, разрешение зависимостей в Package Manager, страну в профилях пользователей и дружественные URL. Перед проверкой очистите кеш браузера для менеджера.
diff --git a/ru/getting-started/maintenance/upgrading/2.5.md b/ru/getting-started/maintenance/upgrading/2.5.md
new file mode 100644
index 000000000..b33eaa14e
--- /dev/null
+++ b/ru/getting-started/maintenance/upgrading/2.5.md
@@ -0,0 +1,45 @@
+---
+title: "Обновление до 2.5"
+translation: "getting-started/maintenance/upgrading/2.5"
+sortorder: 93
+---
+
+MODX Revolution 2.5.0 (апрель 2016) готовит ядро к PHP 7, улучшает менеджер и ускоряет анонимные запросы. Страница для перехода на линейку 2.5. Полный список тикетов: [`core/docs/changelog.txt`](https://github.com/modxcms/revolution/blob/2.x/core/docs/changelog.txt) в репозитории Revolution.
+
+Обзор релиза: [MODX Revolution 2.5—PHP 7, Performance and More](https://modx.com/blog/2016/04/21/modx-revolution-2.5/).
+
+## Перед обновлением
+
+- Хост должен тянуть PHP 5.3+ для 2.5.x. Если есть PHP 7, лучше сразу на него. Поддержка PHP 7 в этой линейке есть (в том числе правки `modPhpThumb`).
+- Сначала обновите Extras на текущей версии, очистите `core/cache` и сбросьте сессии, затем запускайте setup.
+
+## Что меняет поведение
+
+### `anonymous_sessions`
+
+В 2.5 появляется настройка [`anonymous_sessions`](building-sites/settings/anonymous_sessions): анонимные запросы к фронтенду могут обходиться без PHP-сессий.
+
+- По умолчанию Yes (сессии у анонимов остаются, пока вы сами не отключите).
+- Ставьте No только как настройку **контекста** на фронтенд-контексте без сессий. No в системных настройках может закрыть вход в менеджер.
+
+### Сжатие JS/CSS менеджера
+
+`compress_js` больше не минифицирует ассеты менеджера на лету. В ядре лежат готовые `min.js` / CSS-бандлы. Это убирает частые поломки менеджера из-за минификатора. Кто правит core-ассеты менеджера, тот пересобирает бандлы. Обычному обновлению сайта дополнительные шаги не нужны.
+
+### Очистка при апгрейде
+
+Setup удаляет часть устаревших файлов ядра. Держите бэкап дерева до setup, если у вас были патчи в удаляемых путях.
+
+## Заметные дополнения (без обязательной смены конфига)
+
+- Более удобный менеджер на мобильных и доработки accessibility на экране логина.
+- Новый базовый шаблон / стартовый контент для чистых установок.
+- Выходные фильтры `stripmodxtags` и `htmlspecial`.
+- Распаковка zip в дереве файлов / медиа.
+- `modParsedManagerController` для CMP со сниппетами и чанками.
+- Поиск ресурса по ID в Uberbar.
+- Обновления Smarty и PHPMailer (обратная совместимость Smarty вернули в 2.5.0-rc2).
+
+## После setup
+
+Очистите кеш браузера для домена менеджера, чтобы подтянуть новые статические бандлы. Проверьте логин, Package Manager и Extra, которые цепляются к JS менеджера.
diff --git a/ru/getting-started/maintenance/upgrading/2.6.md b/ru/getting-started/maintenance/upgrading/2.6.md
new file mode 100644
index 000000000..30e0f91af
--- /dev/null
+++ b/ru/getting-started/maintenance/upgrading/2.6.md
@@ -0,0 +1,47 @@
+---
+title: "Обновление до 2.6"
+translation: "getting-started/maintenance/upgrading/2.6"
+sortorder: 92
+---
+
+MODX Revolution 2.6.0 (ноябрь 2017) — крупный релиз по стабильности и UX менеджера. Страница для перехода на линейку 2.6. Полный список тикетов: [`core/docs/changelog.txt`](https://github.com/modxcms/revolution/blob/2.x/core/docs/changelog.txt).
+
+Обзор релиза: [A Major New Milestone for MODX Revolution](https://modx.com/blog/modx-revolution-2-6).
+
+## Перед обновлением
+
+- Удобная точка входа — 2.5.8 (или более поздний 2.5.x). Со старых 2.x тоже обновляются, но Extra и свой код нужно сильнее прогнать руками.
+- Обновите пакеты, очистите `core/cache`, сбросьте сессии, затем setup.
+
+## База данных
+
+### InnoDB на новых установках
+
+Новые установки на MySQL создают таблицы с движком **InnoDB**, если сервер его поддерживает. Уже существующие MyISAM-сайты после апгрейда остаются на своём движке. Конвертацию можно сделать позже. См. [How to change your MyISAM DB to InnoDB using phpMyAdmin](https://modx.com/blog/convert-myisam-to-innodb-with-phpmyadmin).
+
+### Индексы utf8mb4
+
+Префиксы индексов по `varchar` / `text` укоротили под **utf8mb4**. Это важно для новых установок и хостов, где utf8mb4 уже включён. Если после апгрейда меняете collation вручную, сверьте длины индексов с лимитами MySQL.
+
+## Поведение и безопасность
+
+- **TV `@EVAL`:** поставьте [`allow_tv_eval`](building-sites/settings/allow_tv_eval) в No, чтобы отключить EVAL (`#13224`). На проде без нужды в EVAL лучше выключить.
+- **Кешируемые и некешируемые теги:** починили обработку некешируемых элементов внутри кешируемых (`#13530`). Перепроверьте страницы, где `!`-теги сидят внутри кешируемых чанков/сниппетов.
+- **`failed_login_attempts`:** настройка снова соблюдается (`#13516`). Проверьте блокировку после неудачных логинов.
+- **PHP 7:** закрыли ошибки сессий и смежные проблемы. На PHP 7 всё равно прогоните логин в менеджере и сессию на фронте.
+- При install / uninstall / remove пакетов появляются новые события (`#12936`). Плагины со старым набором событий стоит просмотреть.
+
+## Заметные дополнения менеджера и API
+
+- Виджет Who's Online на дашборде.
+- Превью SVG в Media Browser.
+- Кастомные top menu менеджера (`#12554`).
+- Событие `OnResourceCacheUpdate` для сторонних кешей.
+- Опция не дублировать ресурсы при дублировании контекста.
+- В разрешённые типы загрузки по умолчанию добавлены `.less`, `.scss`, `.sass`, `.css.map`.
+- Атрибуты DKIM в PHPMailer.
+- REST: `OPTIONS` в `modRestController`, потоковая загрузка бинарных файлов.
+
+## После setup
+
+Очистите кеш браузера менеджера. Проверьте Package Manager, загрузки медиа, блокировку логина и виджеты дашборда. На MyISAM конвертацию в InnoDB планируйте только после полного бэкапа БД.
diff --git a/ru/getting-started/maintenance/upgrading/2.7.md b/ru/getting-started/maintenance/upgrading/2.7.md
new file mode 100644
index 000000000..2496cd5eb
--- /dev/null
+++ b/ru/getting-started/maintenance/upgrading/2.7.md
@@ -0,0 +1,56 @@
+---
+title: "Обновление до 2.7"
+translation: "getting-started/maintenance/upgrading/2.7"
+sortorder: 91
+---
+
+MODX Revolution 2.7.0 (ноябрь 2018) добавляет Trash Manager, нативное хеширование паролей, автоматизацию статических элементов и усиливает Media Browser. Страница для перехода на линейку 2.7. Полный список тикетов: [`core/docs/changelog.txt`](https://github.com/modxcms/revolution/blob/2.x/core/docs/changelog.txt).
+
+Обзор релиза: [Revolution 2.7: An Impressive and Feature-Packed Release](https://modx.com/blog/modx-revolution-2.7).
+
+## Перед обновлением
+
+- Слейте **все** файлы ядра из пакета релиза. Неполная заливка (особенно `core/docs/` и шаблоны setup) уже ломала запись `config.inc.php`, когда из шаблонов убрали устаревшие ключи вроде `cache_disabled`.
+- Сохраните копию `core/config/config.inc.php` до setup. Если setup запишет в файл нераскрытые `{placeholders}`, верните бэкап и запустите setup снова с полным деревом файлов.
+- Обновите Extra, очистите `core/cache`, сбросьте сессии.
+
+## Ломающие и критичные изменения
+
+### Удалённые настройки
+
+Убрали неработающую `cache_disabled` и `cache_system_settings` из системных настроек. Не возвращайте эти ключи руками. Если старый скрипт деплоя или Extra всё ещё их пишет, уберите это после апгрейда.
+
+### Хеширование паролей
+
+Пароли пользователей идут через **нативное PHP password hashing** (`#13926`). Старые хеши продолжают работать через обычный путь логина. Свои скрипты импорта/сброса паролей, которые кладут сырой MD5 в `modUser`, нужно перевести на актуальный hash class / `hash_class`.
+
+### Устаревшие утилиты парсера 0.9.x
+
+Хелперы миграции со старого парсера 0.9.x помечены deprecated и логируются к удалению в 3.0 (`#14131`). Допрыгните эту миграцию до перехода на MODX 3.
+
+### Media Browser и пути
+
+- Некорректные относительные пути media source больше не открывают корень ФС (`#14038`).
+- Очистка `modFileRegister` больше не удаляет произвольные пути (`#13980`).
+- В phpThumb параметры пользователя фильтруются (`#13979`).
+
+Перепроверьте кастомные media source с нестандартной относительной базой.
+
+## Что настроить после апгрейда
+
+- **Trash Manager** для восстановления / окончательного удаления ресурсов (`#14058`).
+- Workflow **automatic static elements** (`#14135`), если элементы лежат на диске.
+- **`automatic_template_assignment`** (`#13700`).
+- Опция ресурса **Use current alias in alias path**, чтобы убрать сегмент из URI (`#11153`).
+- Право **`set_sudo`** (`#13807`) для контролируемого sudo.
+- **Purge Old Versions** в Package Management (`#12818`).
+- Установка проекта через Composer и **CLI setup** (`#13790`).
+- Настраиваемый путь к error.log (`#13768`) и класс кастомного error handler (`#14119`).
+- Выходной фильтр `filterPathSegment` (`#13699`).
+- Wildcard в Form Customization для actions (`#13775`).
+
+## После setup
+
+Проверьте логин в менеджере (путь хеша пароля), Trash Manager, media source и purge в Package Manager. Если `config.inc.php` выглядит сломанным, верните файл до апгрейда и снова запустите setup с полным деревом 2.7.
+
+Перед переходом на MODX 3 сначала закройте всё, что ещё держится за deprecated-утилиты 0.9.x. См. [руководство по обновлению на MODX 3](https://docs.modx.com/3.x/ru/getting-started/upgrading-to-3.0).
diff --git a/ru/getting-started/maintenance/upgrading/2.8.md b/ru/getting-started/maintenance/upgrading/2.8.md
new file mode 100644
index 000000000..6c10544b5
--- /dev/null
+++ b/ru/getting-started/maintenance/upgrading/2.8.md
@@ -0,0 +1,62 @@
+---
+title: "Обновление до 2.8"
+translation: "getting-started/maintenance/upgrading/2.8"
+sortorder: 89
+---
+
+MODX Revolution 2.8.0 (октябрь 2020) усиливает безопасность менеджера, работу с файлами и обновляет библиотеки. Используйте эту страницу при переходе на линейку 2.8. Перед установкой более позднего 2.8 прочитайте [заметки для 2.8.2 / 2.8.3](getting-started/maintenance/upgrading/2.8.2).
+
+Обзор релиза: [MODX Revolution 2.8](https://modx.com/blog/modx-revolution-2.8).
+
+## Перед обновлением
+
+- Ставьте последний доступный патч 2.8.x. Не останавливайтесь на 2.8.0.
+- Обновите Extras, очистите `core/cache`, сбросьте сессии и сделайте резервные копии базы данных и файлов.
+- Слейте полное дерево релиза до запуска setup. В 2.8.0 исправили фатальную ошибку при обновлении с 2.5.x и старше, но setup по-прежнему нужны все актуальные файлы ядра.
+- Составьте список media source, доступных каждому ограниченному пользователю менеджера. Новые проверки прав могут закрыть доступ к файлам, который раньше пользователь получал по ошибке.
+
+## Безопасность и права
+
+2.8.0 закрывает несколько хранимых XSS в менеджере и усиливает файловые операции:
+
+- Ограниченные пользователи менеджера работают с файлами только в доступных им media source.
+- Загрузка файлов и дерево файлов получили более строгую защиту от XSS.
+- `modRestService` блокирует потенциальный XXE.
+- Сообщения реестра блокируют обход путей.
+- Имена шаблонов экранируются в таблицах доступа шаблонов и TV.
+
+Эти исправления затрагивают авторизованных пользователей менеджера. Проверьте свои страницы менеджера, файловые браузеры и ACL под учётной записью без прав администратора.
+
+## Файлы и изображения
+
+- `webp` добавлен в стандартные списки загружаемых файлов и изображений.
+- Загрузчик проверяет наличие файла и исправляет выбор пути.
+- Экран входа получил адаптивные стили.
+- phpThumb обновлён до 1.7.15.
+
+Если вы поддерживаете свой список расширений, добавляйте `webp`, только когда сервер и обработчик изображений его поддерживают.
+
+## TV и настройки
+
+- TV типов URL, RichText, Image и File получили параметр **Allow Blank**.
+- TV Listbox (Multi-Select) принимает свои значения.
+- Для системных настроек появился числовой тип поля.
+
+Проверьте валидацию TV, где пустое значение должно оставаться запрещённым. Новый параметр задаёт это правило явно.
+
+## Обновления библиотек
+
+В 2.8.0 обновлены:
+
+- xPDO до 2.8.1
+- Smarty до 3.1.36
+- PHPMailer до 5.2.28
+- phpThumb до 1.7.15
+
+После setup проверьте свои плагины Smarty, отправку почты и обработку изображений.
+
+## После setup
+
+Войдите как администратор и под каждой ограниченной ролью менеджера. Проверьте доступ к media source, загрузку файлов, валидацию TV, корзину ресурсов, отправку почты и страницы менеджера от Extras.
+
+Перед переходом с 2.8.1 прочитайте [Обновление до 2.8.2 и 2.8.3](getting-started/maintenance/upgrading/2.8.2). Эти релизы ужесточают пути и права статических ресурсов, поэтому могут потребовать настройки.

From d928495a78051e449b71434728188042fa992ae4 Mon Sep 17 00:00:00 2001
From: Ivan Bochkarev <ivanx86@gmail.com>
Date: Mon, 17 Aug 2026 18:09:59 +0600
Subject: [PATCH 2/2] =?UTF-8?q?docs(upgrading):=20Drop=20AI=20phrasing=20i?=
 =?UTF-8?q?n=202.4=E2=80=932.8=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Replace ticket list / smoke test wording and trim formulaic intros
called out in review on #600.
---
 en/getting-started/maintenance/upgrading/2.4.md |  2 +-
 en/getting-started/maintenance/upgrading/2.5.md |  6 +++---
 en/getting-started/maintenance/upgrading/2.6.md | 12 ++++++------
 en/getting-started/maintenance/upgrading/2.7.md |  6 +++---
 en/getting-started/maintenance/upgrading/2.8.md |  2 +-
 ru/getting-started/maintenance/upgrading/2.4.md |  6 +++---
 ru/getting-started/maintenance/upgrading/2.5.md |  6 +++---
 ru/getting-started/maintenance/upgrading/2.6.md |  6 +++---
 ru/getting-started/maintenance/upgrading/2.7.md |  6 +++---
 ru/getting-started/maintenance/upgrading/2.8.md |  6 +++---
 10 files changed, 29 insertions(+), 29 deletions(-)

diff --git a/en/getting-started/maintenance/upgrading/2.4.md b/en/getting-started/maintenance/upgrading/2.4.md
index b85b610bf..3fd592e61 100644
--- a/en/getting-started/maintenance/upgrading/2.4.md
+++ b/en/getting-started/maintenance/upgrading/2.4.md
@@ -3,7 +3,7 @@ title: "Upgrading to 2.4"
 sortorder: 95
 ---
 
-MODX Revolution 2.4.0 (August 2015) adds package dependencies, namespace permissions, database indexes, and manager improvements. Use this page when you move onto the 2.4 line. For the full ticket list, see [`core/docs/changelog.txt`](https://github.com/modxcms/revolution/blob/2.x/core/docs/changelog.txt).
+MODX Revolution 2.4.0 (August 2015) adds package dependencies, namespace permissions, database indexes, and manager improvements. Full changelog: [`core/docs/changelog.txt`](https://github.com/modxcms/revolution/blob/2.x/core/docs/changelog.txt).
 
 Release overviews:
 
diff --git a/en/getting-started/maintenance/upgrading/2.5.md b/en/getting-started/maintenance/upgrading/2.5.md
index c5bb2bcca..b61ec436c 100644
--- a/en/getting-started/maintenance/upgrading/2.5.md
+++ b/en/getting-started/maintenance/upgrading/2.5.md
@@ -3,7 +3,7 @@ title: "Upgrading to 2.5"
 sortorder: 93
 ---
 
-MODX Revolution 2.5.0 (April 2016) focused on PHP 7 readiness, manager usability, and anonymous-request performance. Use this page when you move a site onto the 2.5 line. For the full list of tickets, see [`core/docs/changelog.txt`](https://github.com/modxcms/revolution/blob/2.x/core/docs/changelog.txt) in the Revolution repo.
+MODX Revolution 2.5.0 (April 2016) focused on PHP 7 readiness, manager usability, and anonymous-request performance. Full changelog: [`core/docs/changelog.txt`](https://github.com/modxcms/revolution/blob/2.x/core/docs/changelog.txt).
 
 Release overview: [MODX Revolution 2.5—PHP 7, Performance and More](https://modx.com/blog/2016/04/21/modx-revolution-2.5/).
 
@@ -12,7 +12,7 @@ Release overview: [MODX Revolution 2.5—PHP 7, Performance and More](https://mo
 - Confirm the host can run PHP 5.3+ for 2.5.x. Prefer PHP 7 if the host offers it. PHP 7 support landed in this line (`modPhpThumb` and related fixes).
 - Update Extras on the current version first, then clear `core/cache` and flush sessions before setup.
 
-## Things that change behaviour
+## Behaviour changes
 
 ### `anonymous_sessions`
 
@@ -29,7 +29,7 @@ Release overview: [MODX Revolution 2.5—PHP 7, Performance and More](https://mo
 
 Setup removes selected legacy core files during upgrade. Keep a backup of the tree before you run setup so you can compare if a custom patch lived in a removed path.
 
-## Notable additions (no forced config change)
+## Other additions
 
 - More mobile-friendly manager layout and login accessibility work.
 - New default manager template / starter content for fresh installs.
diff --git a/en/getting-started/maintenance/upgrading/2.6.md b/en/getting-started/maintenance/upgrading/2.6.md
index 6db55638d..4fa6a58b9 100644
--- a/en/getting-started/maintenance/upgrading/2.6.md
+++ b/en/getting-started/maintenance/upgrading/2.6.md
@@ -3,13 +3,13 @@ title: "Upgrading to 2.6"
 sortorder: 92
 ---
 
-MODX Revolution 2.6.0 (November 2017) is a large stability and manager UX release. Use this page when you move onto the 2.6 line. Full ticket list: [`core/docs/changelog.txt`](https://github.com/modxcms/revolution/blob/2.x/core/docs/changelog.txt).
+MODX Revolution 2.6.0 (November 2017) is a large stability and manager UX release. Full changelog: [`core/docs/changelog.txt`](https://github.com/modxcms/revolution/blob/2.x/core/docs/changelog.txt).
 
 Release overview: [A Major New Milestone for MODX Revolution](https://modx.com/blog/modx-revolution-2-6).
 
 ## Before you upgrade
 
-- Prefer 2.5.8 (or later 2.5.x) as the jump-off point when you can. Older 2.x sites still upgrade, but Extras and custom code need more smoke-testing.
+- Prefer 2.5.8 (or later 2.5.x) as the starting point when you can. Older 2.x sites still upgrade, but Extras and custom code need more careful testing.
 - Update packages, clear `core/cache`, flush sessions, then run setup.
 
 ## Database notes
@@ -22,15 +22,15 @@ New MySQL installs create tables with the **InnoDB** engine when the server supp
 
 Index prefixes on `varchar` / `text` columns were shortened so MySQL can use **utf8mb4**. That mainly matters for new installs and for hosts that already use utf8mb4. If you change collation manually after upgrade, check index lengths against MySQL limits.
 
-## Behaviour and security to verify
+## Behaviour and security
 
 - **TV `@EVAL` binding:** set [`allow_tv_eval`](building-sites/settings/allow_tv_eval) to No to disable EVAL bindings (`#13224`). Turn it off on production if you do not need it.
 - **Cached vs uncached tags:** processing of non-cacheable elements inside cacheable ones was fixed (`#13530`). Re-check pages that mix `!` tags inside cached chunks/snippets.
 - **`failed_login_attempts`:** the setting is honoured again (`#13516`). Confirm lockout behaviour matches what you expect.
-- **PHP 7:** session callback and related PHP 7 errors in this line were addressed. Still run a manager login and a front-end session smoke test on PHP 7 hosts.
+- **PHP 7:** session callback and related PHP 7 errors in this line were addressed. On PHP 7 hosts, still confirm manager login and that a front-end session works.
 - Package install / uninstall / remove fire new events (`#12936`). Custom plugins that assume the old event set should be reviewed.
 
-## Notable manager and API additions
+## Manager and API additions
 
 - Who's Online dashboard widget.
 - SVG previews in the Media Browser.
@@ -43,4 +43,4 @@ Index prefixes on `varchar` / `text` columns were shortened so MySQL can use **u
 
 ## After setup
 
-Clear manager browser cache. Spot-check Package Manager, media uploads, user login lockout, and any dashboard widgets. On MyISAM hosts, plan an InnoDB conversion only after a full database backup.
+Clear the manager browser cache. Check Package Manager, media uploads, login lockout, and any dashboard widgets. On MyISAM hosts, convert to InnoDB only after a full database backup.
diff --git a/en/getting-started/maintenance/upgrading/2.7.md b/en/getting-started/maintenance/upgrading/2.7.md
index 2c2bb7579..9a2feafea 100644
--- a/en/getting-started/maintenance/upgrading/2.7.md
+++ b/en/getting-started/maintenance/upgrading/2.7.md
@@ -3,7 +3,7 @@ title: "Upgrading to 2.7"
 sortorder: 91
 ---
 
-MODX Revolution 2.7.0 (November 2018) adds Trash Manager, native password hashing, static-element automation, and several Media Browser hardenings. Use this page when you move onto the 2.7 line. Full ticket list: [`core/docs/changelog.txt`](https://github.com/modxcms/revolution/blob/2.x/core/docs/changelog.txt).
+MODX Revolution 2.7.0 (November 2018) adds Trash Manager, native password hashing, static-element automation, and Media Browser security fixes. Full changelog: [`core/docs/changelog.txt`](https://github.com/modxcms/revolution/blob/2.x/core/docs/changelog.txt).
 
 Release overview: [Revolution 2.7: An Impressive and Feature-Packed Release](https://modx.com/blog/modx-revolution-2.7).
 
@@ -13,7 +13,7 @@ Release overview: [Revolution 2.7: An Impressive and Feature-Packed Release](htt
 - Keep a copy of `core/config/config.inc.php` before setup. If setup writes unresolved `{placeholders}` into that file, restore the backup and run setup again with a complete file tree.
 - Update Extras, clear `core/cache`, flush sessions.
 
-## Breaking / high-impact changes
+## Breaking changes
 
 ### Removed settings
 
@@ -35,7 +35,7 @@ Migration helpers aimed at the old 0.9.x parser are deprecated and logged for re
 
 Re-test custom media sources that rely on unusual relative bases.
 
-## Features worth configuring after upgrade
+## Features to configure after upgrade
 
 - **Trash Manager** for restore / purge of deleted resources (`#14058`).
 - **Automatic static elements** workflow (`#14135`) if you keep elements on disk.
diff --git a/en/getting-started/maintenance/upgrading/2.8.md b/en/getting-started/maintenance/upgrading/2.8.md
index ad4b2682d..95a8c8f78 100644
--- a/en/getting-started/maintenance/upgrading/2.8.md
+++ b/en/getting-started/maintenance/upgrading/2.8.md
@@ -3,7 +3,7 @@ title: "Upgrading to 2.8"
 sortorder: 89
 ---
 
-MODX Revolution 2.8.0 (October 2020) focuses on manager security, file handling, and library updates. Use this page when you enter the 2.8 line. Continue with [the 2.8.2 / 2.8.3 notes](getting-started/maintenance/upgrading/2.8.2) before installing a later 2.8 release.
+MODX Revolution 2.8.0 (October 2020) focuses on manager security, file handling, and library updates. Read [the 2.8.2 / 2.8.3 notes](getting-started/maintenance/upgrading/2.8.2) before you install a later 2.8 release.
 
 Release overview: [MODX Revolution 2.8](https://modx.com/blog/modx-revolution-2.8).
 
diff --git a/ru/getting-started/maintenance/upgrading/2.4.md b/ru/getting-started/maintenance/upgrading/2.4.md
index e33ea088d..2200749a4 100644
--- a/ru/getting-started/maintenance/upgrading/2.4.md
+++ b/ru/getting-started/maintenance/upgrading/2.4.md
@@ -4,7 +4,7 @@ translation: "getting-started/maintenance/upgrading/2.4"
 sortorder: 95
 ---
 
-MODX Revolution 2.4.0 (август 2015) добавляет зависимости пакетов, права пространств имён, индексы базы данных и улучшения менеджера. Используйте эту страницу при переходе на линейку 2.4. Полный список тикетов находится в [`core/docs/changelog.txt`](https://github.com/modxcms/revolution/blob/2.x/core/docs/changelog.txt).
+MODX Revolution 2.4.0 (август 2015) добавляет зависимости пакетов, права пространств имён, индексы базы данных и улучшения менеджера. Полный changelog: [`core/docs/changelog.txt`](https://github.com/modxcms/revolution/blob/2.x/core/docs/changelog.txt).
 
 Обзоры релиза:
 
@@ -29,7 +29,7 @@ MODX Revolution 2.4.0 (август 2015) добавляет зависимос
 
 ### Контроль доступа и пространства имён
 
-В 2.4 появились права пространств имён, а дерево групп пользователей объединили с таблицей пользователей на странице ACL. После setup проверьте свои политики доступа и учётные записи менеджера.
+В 2.4 появились права пространств имён, а дерево групп пользователей объединили с таблицей пользователей на странице ACL. После установки проверьте свои политики доступа и учётные записи менеджера.
 
 ### Зависимости пакетов
 
@@ -51,6 +51,6 @@ MODX Revolution 2.4.0 (август 2015) добавляет зависимос
 
 В 2.4.3 появилась регрессия выходных фильтров на неопределённых плейсхолдерах. MODX 2.4.4 исправил её. Ставьте последний патч 2.4.x и проверьте страницы, где выходные модификаторы применяются к отсутствующим значениям.
 
-## После setup
+## После установки
 
 Проверьте вход в менеджер, ACL, разрешение зависимостей в Package Manager, страну в профилях пользователей и дружественные URL. Перед проверкой очистите кеш браузера для менеджера.
diff --git a/ru/getting-started/maintenance/upgrading/2.5.md b/ru/getting-started/maintenance/upgrading/2.5.md
index b33eaa14e..d0fae440f 100644
--- a/ru/getting-started/maintenance/upgrading/2.5.md
+++ b/ru/getting-started/maintenance/upgrading/2.5.md
@@ -4,7 +4,7 @@ translation: "getting-started/maintenance/upgrading/2.5"
 sortorder: 93
 ---
 
-MODX Revolution 2.5.0 (апрель 2016) готовит ядро к PHP 7, улучшает менеджер и ускоряет анонимные запросы. Страница для перехода на линейку 2.5. Полный список тикетов: [`core/docs/changelog.txt`](https://github.com/modxcms/revolution/blob/2.x/core/docs/changelog.txt) в репозитории Revolution.
+MODX Revolution 2.5.0 (апрель 2016) готовит ядро к PHP 7, улучшает менеджер и ускоряет анонимные запросы. Полный changelog: [`core/docs/changelog.txt`](https://github.com/modxcms/revolution/blob/2.x/core/docs/changelog.txt).
 
 Обзор релиза: [MODX Revolution 2.5—PHP 7, Performance and More](https://modx.com/blog/2016/04/21/modx-revolution-2.5/).
 
@@ -30,7 +30,7 @@ MODX Revolution 2.5.0 (апрель 2016) готовит ядро к PHP 7, ул
 
 Setup удаляет часть устаревших файлов ядра. Держите бэкап дерева до setup, если у вас были патчи в удаляемых путях.
 
-## Заметные дополнения (без обязательной смены конфига)
+## Другие дополнения
 
 - Более удобный менеджер на мобильных и доработки accessibility на экране логина.
 - Новый базовый шаблон / стартовый контент для чистых установок.
@@ -40,6 +40,6 @@ Setup удаляет часть устаревших файлов ядра. Де
 - Поиск ресурса по ID в Uberbar.
 - Обновления Smarty и PHPMailer (обратная совместимость Smarty вернули в 2.5.0-rc2).
 
-## После setup
+## После установки
 
 Очистите кеш браузера для домена менеджера, чтобы подтянуть новые статические бандлы. Проверьте логин, Package Manager и Extra, которые цепляются к JS менеджера.
diff --git a/ru/getting-started/maintenance/upgrading/2.6.md b/ru/getting-started/maintenance/upgrading/2.6.md
index 30e0f91af..8898b73e5 100644
--- a/ru/getting-started/maintenance/upgrading/2.6.md
+++ b/ru/getting-started/maintenance/upgrading/2.6.md
@@ -4,7 +4,7 @@ translation: "getting-started/maintenance/upgrading/2.6"
 sortorder: 92
 ---
 
-MODX Revolution 2.6.0 (ноябрь 2017) — крупный релиз по стабильности и UX менеджера. Страница для перехода на линейку 2.6. Полный список тикетов: [`core/docs/changelog.txt`](https://github.com/modxcms/revolution/blob/2.x/core/docs/changelog.txt).
+MODX Revolution 2.6.0 (ноябрь 2017) — крупный релиз по стабильности и UX менеджера. Полный changelog: [`core/docs/changelog.txt`](https://github.com/modxcms/revolution/blob/2.x/core/docs/changelog.txt).
 
 Обзор релиза: [A Major New Milestone for MODX Revolution](https://modx.com/blog/modx-revolution-2-6).
 
@@ -31,7 +31,7 @@ MODX Revolution 2.6.0 (ноябрь 2017) — крупный релиз по с
 - **PHP 7:** закрыли ошибки сессий и смежные проблемы. На PHP 7 всё равно прогоните логин в менеджере и сессию на фронте.
 - При install / uninstall / remove пакетов появляются новые события (`#12936`). Плагины со старым набором событий стоит просмотреть.
 
-## Заметные дополнения менеджера и API
+## Дополнения менеджера и API
 
 - Виджет Who's Online на дашборде.
 - Превью SVG в Media Browser.
@@ -42,6 +42,6 @@ MODX Revolution 2.6.0 (ноябрь 2017) — крупный релиз по с
 - Атрибуты DKIM в PHPMailer.
 - REST: `OPTIONS` в `modRestController`, потоковая загрузка бинарных файлов.
 
-## После setup
+## После установки
 
 Очистите кеш браузера менеджера. Проверьте Package Manager, загрузки медиа, блокировку логина и виджеты дашборда. На MyISAM конвертацию в InnoDB планируйте только после полного бэкапа БД.
diff --git a/ru/getting-started/maintenance/upgrading/2.7.md b/ru/getting-started/maintenance/upgrading/2.7.md
index 2496cd5eb..b5c69866a 100644
--- a/ru/getting-started/maintenance/upgrading/2.7.md
+++ b/ru/getting-started/maintenance/upgrading/2.7.md
@@ -4,7 +4,7 @@ translation: "getting-started/maintenance/upgrading/2.7"
 sortorder: 91
 ---
 
-MODX Revolution 2.7.0 (ноябрь 2018) добавляет Trash Manager, нативное хеширование паролей, автоматизацию статических элементов и усиливает Media Browser. Страница для перехода на линейку 2.7. Полный список тикетов: [`core/docs/changelog.txt`](https://github.com/modxcms/revolution/blob/2.x/core/docs/changelog.txt).
+MODX Revolution 2.7.0 (ноябрь 2018) добавляет Trash Manager, нативное хеширование паролей, автоматизацию статических элементов и правки безопасности Media Browser. Полный changelog: [`core/docs/changelog.txt`](https://github.com/modxcms/revolution/blob/2.x/core/docs/changelog.txt).
 
 Обзор релиза: [Revolution 2.7: An Impressive and Feature-Packed Release](https://modx.com/blog/modx-revolution-2.7).
 
@@ -14,7 +14,7 @@ MODX Revolution 2.7.0 (ноябрь 2018) добавляет Trash Manager, на
 - Сохраните копию `core/config/config.inc.php` до setup. Если setup запишет в файл нераскрытые `{placeholders}`, верните бэкап и запустите setup снова с полным деревом файлов.
 - Обновите Extra, очистите `core/cache`, сбросьте сессии.
 
-## Ломающие и критичные изменения
+## Ломающие изменения
 
 ### Удалённые настройки
 
@@ -49,7 +49,7 @@ MODX Revolution 2.7.0 (ноябрь 2018) добавляет Trash Manager, на
 - Выходной фильтр `filterPathSegment` (`#13699`).
 - Wildcard в Form Customization для actions (`#13775`).
 
-## После setup
+## После установки
 
 Проверьте логин в менеджере (путь хеша пароля), Trash Manager, media source и purge в Package Manager. Если `config.inc.php` выглядит сломанным, верните файл до апгрейда и снова запустите setup с полным деревом 2.7.
 
diff --git a/ru/getting-started/maintenance/upgrading/2.8.md b/ru/getting-started/maintenance/upgrading/2.8.md
index 6c10544b5..367fce1e2 100644
--- a/ru/getting-started/maintenance/upgrading/2.8.md
+++ b/ru/getting-started/maintenance/upgrading/2.8.md
@@ -4,7 +4,7 @@ translation: "getting-started/maintenance/upgrading/2.8"
 sortorder: 89
 ---
 
-MODX Revolution 2.8.0 (октябрь 2020) усиливает безопасность менеджера, работу с файлами и обновляет библиотеки. Используйте эту страницу при переходе на линейку 2.8. Перед установкой более позднего 2.8 прочитайте [заметки для 2.8.2 / 2.8.3](getting-started/maintenance/upgrading/2.8.2).
+MODX Revolution 2.8.0 (октябрь 2020) усиливает безопасность менеджера, работу с файлами и обновляет библиотеки. Перед установкой более позднего 2.8 прочитайте [заметки для 2.8.2 / 2.8.3](getting-started/maintenance/upgrading/2.8.2).
 
 Обзор релиза: [MODX Revolution 2.8](https://modx.com/blog/modx-revolution-2.8).
 
@@ -53,9 +53,9 @@ MODX Revolution 2.8.0 (октябрь 2020) усиливает безопасн
 - PHPMailer до 5.2.28
 - phpThumb до 1.7.15
 
-После setup проверьте свои плагины Smarty, отправку почты и обработку изображений.
+После установки проверьте свои плагины Smarty, отправку почты и обработку изображений.
 
-## После setup
+## После установки
 
 Войдите как администратор и под каждой ограниченной ролью менеджера. Проверьте доступ к media source, загрузку файлов, валидацию TV, корзину ресурсов, отправку почты и страницы менеджера от Extras.