Skip to content

Commit 3884104

Browse files
authored
Review from @stevepiercy
Mostly style guide stuff, but I added a clause to the final bullet point that needs review from @mauritsvanrees: ``` Add the `plone.app.discussion` package to your dependencies, and run the migration again. ```
1 parent d4abb61 commit 3884104

File tree

1 file changed

+9
-8
lines changed

1 file changed

+9
-8
lines changed

docs/backend/upgrading/version-specific-migration/upgrade-to-61.md

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -105,14 +105,15 @@ To enable discussion, you need to perform the following tasks.
105105
1. Run pip to install `plone.app.discussion`.
106106
1. Restart the Plone backend to load `plone.app.discussion`.
107107
1. Enable the {guilabel}`Discussion Support` add-on in the {guilabel}`Add-ons` control panel under {menuselection}`Site Setup --> General`.
108-
1. If you use Plone Classic UI, you can then use the {guilabel}`Discussion` control panel to further configure this feature, for example for enabling comment moderation.
108+
1. If you use Plone Classic UI, you can then use the {guilabel}`Discussion` control panel to further configure this feature, for example, to enable comment moderation.
109109
1. 🍻
110110
111-
If you have an existing Plone 5.2 or 6.0 site and you migrate to 6.1, then migration code handles the change:
111+
If you have an existing Plone 5.2 or 6.0 site and you migrate to 6.1, then migration code handles the change as follows.
112112
113-
* If the `plone.app.discussion` Python package is in your setup, the migration does nothing: existing discussion configuration and comments remain unchanged.
114-
* If the `plone.app.discussion` Python package is _not_ in your setup, and the site has no existing comments (discussions), then the migration code removes the Discussion configuration from your site.
115-
Apparently you were _not_ using comments in your site, so the configuration is no longer needed.
116-
* If the `plone.app.discussion` Python package is _not_ in your setup, but the site has existing comments (discussions), then the migration code stops with an error.
117-
Apparently you _were_ using comments in your site.
118-
Easiest solution here is to add the `plone.app.discussion` package to your dependencies.
113+
- If the `plone.app.discussion` Python package is in your setup, the migration does nothing.
114+
Existing discussion configuration and comments remain unchanged.
115+
- If the `plone.app.discussion` Python package is _not_ in your setup, and the site has no existing comments (discussions), then the migration code removes the Discussion configuration from your site.
116+
Apparently you were _not_ using comments in your site, so the configuration is no longer needed.
117+
- If the `plone.app.discussion` Python package is _not_ in your setup, but the site has existing comments (discussions), then the migration code stops with an error.
118+
Apparently you _were_ using comments in your site.
119+
Add the `plone.app.discussion` package to your dependencies, and run the migration again.

0 commit comments

Comments
 (0)