You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/backend/upgrading/intro.md
+7-9Lines changed: 7 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -81,18 +81,16 @@ It just fixed a bug.
81
81
A post on the Community forum, [Rules for Plone 6 development during the beta stage](https://community.plone.org/t/rules-for-plone-6-development-during-the-beta-stage/15432), discusses alpha and beta versioning.
82
82
```
83
83
84
-
In addition to the general procedure there are {ref}`version-specific-upgrade-guide-label`.
In addition to the general upgrade procedure, there are {doc}`version-specific migration guides <version-specific-migration/index>`.
91
-
92
90
These guides contain specific instructions and valuable information that has been collected from real-life migration cases.
93
91
94
-
This approach is recommended for all upgrades of minor version and can work fine for most mayor upgrades.
95
-
When dealing with mayor changes in Plone or with very large or complex installations a export-import based migration (see below) is often the better solution.
92
+
This approach is recommended for all upgrades of minor versions, and can work fine for most major upgrades.
93
+
When dealing with major changes in Plone, or with very large or complex installations, an {ref}`export-import based migration <introduction-upgrade-strategies-export-import-migrations-label>` is often the better solution.
96
94
97
95
(introduction-upgrade-strategies-label)=
98
96
@@ -104,7 +102,7 @@ When dealing with mayor changes in Plone or with very large or complex installat
104
102
### In-place migrations
105
103
106
104
An in-place migration means the content and settings of a Plone installation are being updated while Plone is running.
107
-
These upgrades use a built-in tool
105
+
These upgrades use a built-in tool.
108
106
They run upgrade steps that are collected in [plone.app.upgrade](https://github.com/plone/plone.app.upgrade/).
109
107
110
108
This approach is recommended for all upgrades of feature (minor) versions.
@@ -150,7 +148,7 @@ The following major changes in the history of Plone require special attention wh
150
148
151
149
With Plone 5.0 the default framework for content types switched from Archetypes to Dexterity.
152
150
153
-
Until Plone 5.2.x there is a built-in migration from Archetypes to Dexterity, but it only supports Python 2.
151
+
Up through Plone 5.2.x, there is a built-in migration from Archetypes to Dexterity, but it only supports Python 2.
154
152
See [Migration](https://pypi.org/project/plone.app.contenttypes/2.2.3/#migration) in the latest stable release of `plone.app.contenttypes` for details on the migration of custom and default content types to Dexterity.
155
153
156
154
Using [collective.exportimport](https://pypi.org/project/collective.exportimport/) you can export Archetypes content and import it as Dexterity content.
@@ -160,15 +158,15 @@ Using [collective.exportimport](https://pypi.org/project/collective.exportimport
160
158
161
159
### Plone 5.2: Support for Python 3
162
160
163
-
Plone 5.2 added support for Python 3 while Plone 6.0 dropped support for Python 2.
161
+
Plone 5.2 added support for Python 3, while Plone 6.0 dropped support for Python 2.
164
162
This means that you can use Plone 5.2 to upgrade to Python 3.
165
163
166
164
This requires that you run Plone in Python 3 and only use code that supports Python 3.
167
165
It also requires that you migrate the database in a separate step from Python 2 to 3 while Plone is not running.
168
166
169
-
See the chapters {ref}`migrating-52-to-python3-label` and {ref}`migrate-zodb-to-python3-label` for detailed information on these steps.
167
+
See the chapters {doc}`version-specific-migration/upgrade-to-python3` and {doc}`version-specific-migration/upgrade-zodb-to-python3` for detailed information on these steps.
170
168
171
-
Using [collective.exportimport](https://pypi.org/project/collective.exportimport/) you can export content in Python 2 and import it in Python 3.
169
+
Using [collective.exportimport](https://pypi.org/project/collective.exportimport/), you can export content from Python 2 and import it in Python 3.
0 commit comments