Skip to content

Commit 45be978

Browse files
Improve upgrade preparation.
- Change indentation levels of the first list. - Point to dist.plone.org instead of CMFPlone for the release notes. - Remove instructions on first installing a newer Zope version. This was from the days before Zope and Plone were released as eggs. - Add links to Zope documentation. - Do not tell people to look at README/INSTALL/UPGRADE.txt in CMFPlone. I never update these. - Fix backup link.
1 parent 2364401 commit 45be978

File tree

1 file changed

+14
-23
lines changed

1 file changed

+14
-23
lines changed

docs/backend/upgrading/preparations.md

Lines changed: 14 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -16,54 +16,45 @@ Things to do before you migrate Plone.
1616
## Gather Information
1717

1818
- Read the "What's new in..." for your relevant Plone version, and read the release notes.
19-
20-
- You'll find these in the CMFPlone directory of the distribution of the new version of Plone.
19+
You'll find these on `dist.plone.org` in the release directory of the new version of Plone.
20+
As an example, here are the [6.0.0b2 release notes](https://dist.plone.org/release/6.0.0b2/RELEASE-NOTES.md).
2121

2222
- Make sure to check installed add-ons, if you **do not** need certain add-ons anymore, please deactivate and deinstall.
2323

24-
- Check for dependencies
24+
- Check for dependencies.
2525

2626
- Read the release notes for the Plone release you are upgrading to, in particular:
2727

28-
- What version of Python is required?
28+
- What version of Python is required?
2929

30-
- What version of Zope is required?
30+
- What version of Zope is required?
3131

32-
- Do you need any new Python libraries?
32+
- Do you need any new Python libraries?
3333

3434
- Make sure all the add-on products you are using have updated to support the version of Plone you are upgrading to.
3535

3636
- Start with the third-party products that are in use on your site.
37+
Verify that they have been updated or verified to work on the new version, and get them upgraded in your existing instance before you start the Plone/Zope/Python upgrade if possible.
3738

38-
- Verify that they have been updated or verified to work on the new version, and get them upgraded in your existing instance before you start the Plone/Zope/Python upgrade if possible.
39-
40-
- If Zope depends on a newer version of Python, install the new version of Python first.
41-
42-
- If the newer version of Plone depends on a newer version of Zope, you will need to install that before proceeding with the Plone upgrade.
4339

4440
```{note}
45-
Zope has its own migration guidelines, which you will find in the release notes of the version you are migrating to.
41+
Zope has its own documentation.
42+
Of most interest for migration are:
43+
44+
- [What's new](https://zope.readthedocs.io/en/latest/news.html) on a high level.
45+
- [Migrating between Zope versions](https://zope.readthedocs.io/en/latest/migrations/index.html).
46+
- [Detailed changelog](https://zope.readthedocs.io/en/latest/changes.html).
4647
4748
If Plone is being upgraded at the same time as a Zope version, Plone will usually handle the Zope upgrade with its own migration script.
4849
```
4950

50-
- Read the following files in the CMFPlone directory of the distribution of the new version of Plone you want to update to:
51-
52-
- README.txt
53-
54-
- INSTALL.txt
55-
56-
- UPGRADE.txt (although this usually contains only the general procedure outlined above)
57-
58-
- These files are important because they may contain important last minute information and might be more specific than the relevant sections of this reference manual.
59-
6051
## Back Up Your Plone Site
6152

6253
```{note}
6354
It's important to back up your Plone site.
6455
```
6556

66-
You will find a {doc}`how-to on backing up your Plone site here </manage/deploying/backup>`.
57+
You will find a {doc}`how-to on backing up your Plone site here </deployment/backup>`.
6758

6859
## Setup A Test Environment To Rehearse The Upgrade
6960

0 commit comments

Comments
 (0)