Skip to content

Commit e25b72d

Browse files
committed
Update conceptual guide for distributions, where the significant changes are:
- Use the actual package names of the built-in distributions - Move the comparison to other CMSs to the end of the page, putting Plone-only content first.
1 parent f9b845c commit e25b72d

File tree

1 file changed

+25
-19
lines changed

1 file changed

+25
-19
lines changed

docs/conceptual-guides/distributions.md

Lines changed: 25 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -18,22 +18,15 @@ A Plone distribution is a pre-packaged version of Plone that includes specific f
1818
It is a convenient way to get a specific type of website up and running quickly, as the distribution includes everything needed to run that type of site.
1919

2020

21-
## Similar Concept in Other CMS
22-
23-
- **Drupal:** Drupal has distributions for blogs, e-commerce sites, and intranet portals.
24-
25-
- **WordPress:** WordPress has a similar concept in the form of "WordPress Multisite," which allows users to run multiple websites from a single installation of WordPress.
26-
27-
- **Joomla:** Joomla has a similar concept in the form of "Joomla Templates," which are pre-designed templates for Joomla websites.
28-
29-
- **TYPO3:** TYPO3 has a similar concept in the form of "TYPO3 Distributions," which are pre-configured installations of TYPO3 for specific types of websites.
21+
## Built-in distributions
3022

23+
Plone comes with two built-in distributions, which correspond to the two Plone user interfaces.
3124

32-
## Built-in distributions
25+
[`plone.volto`](https://github.com/plone/plone.volto)
26+
: Create a Plone site with the Volto frontend.
3327

34-
Plone comes with two built-in distributions, which correspond to the two Plone user interfaces:
35-
- `default` (Volto)
36-
- `classic` (Classic UI)
28+
[`plone.classicui`](https://github.com/plone/plone.classicui)
29+
: Create a Plone site with the Classic UI frontend.
3730

3831

3932
## Third-party distributions
@@ -48,8 +41,8 @@ For example, a Plone consulting agency can create a distribution demonstrating i
4841
This would contain the add-ons that they usually add in each project, including example content.
4942
With this, the agency can create a fully configured Plone site filled with content for a potential client.
5043

51-
Or, an agency or implementer can create a distribution for specific project.
52-
This would create a site with all add-ons activated and configured for this project, including example content, and optionally users and groups.
44+
Alternatively, an agency or implementer can create a distribution for specific project.
45+
This could create a site with all add-ons activated and configured for this project, including example content, and optionally users and groups.
5346
During the development phase of a new project, all developers would use this to create a fresh site locally so that everyone has the same configuration and content.
5447

5548
Custom Plone distributions can be distributions for use by others.
@@ -63,17 +56,30 @@ Examples of third-party Plone distributions include:
6356

6457
## Related packages
6558

66-
The implementation of distributions in the Plone codebase is found in the following Python packages:
59+
The implementation of distributions in the Plone codebase is found in the following Python packages.
6760

6861
- [`plone.distribution`](https://github.com/plone/plone.distribution) provides the framework for defining distributions.
6962
- [`plone.exportimport`](https://github.com/plone/plone.exportimport) imports and exports content, users, and other objects between Plone sites.
7063
`plone.distribution` uses it.
71-
- [`plone.volto`](https://github.com/plone/plone.volto) is the distribution to create a Plone site with the default frontend, Volto.
64+
- [`plone.volto`](https://github.com/plone/plone.volto) is the distribution to create a Plone site with the Volto frontend.
7265
- [`plone.classicui`](https://github.com/plone/plone.classicui) is the distribution to create a Plone site with the Classic UI frontend.
7366

7467
```{note}
7568
For Plone 7, the [Plone roadmap](https://plone.org/why-plone/roadmap) guides development toward a clearer separation between the Classic UI frontend and the core `Products.CMFPlone` backend.
76-
This means that in Plone 7, `Products.CMFPlone` will have less code and pull in fewer dependencies.
77-
`plone.classicui` may have more code and pull in more dependencies.
69+
This means that in Plone 7, `Products.CMFPlone` will have less code and pull in fewer dependencies, whereas `plone.classicui` may have more code and pull in more dependencies.
7870
This is the direction in which the backend is heading, and the introduction of the `plone.classicui` distribution package is an important step along this path.
7971
```
72+
73+
## Comparison with other CMSs
74+
75+
Drupal
76+
: Drupal has distributions for blogs, e-commerce sites, and intranet portals.
77+
78+
WordPress
79+
: WordPress has a similar concept in the form of "WordPress Multisite," which allows users to run multiple websites from a single installation of WordPress.
80+
81+
Joomla
82+
: Joomla has a similar concept in the form of "Joomla Templates," which are pre-designed templates for Joomla websites.
83+
84+
TYPO3
85+
: TYPO3 has a similar concept in the form of "TYPO3 Distributions," which are pre-configured installations of TYPO3 for specific types of websites.

0 commit comments

Comments
 (0)