Skip to content

Commit 32134f3

Browse files
committed
update overview
1 parent 44101ef commit 32134f3

File tree

1 file changed

+21
-18
lines changed

1 file changed

+21
-18
lines changed

docs/overview/index.md

Lines changed: 21 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -13,13 +13,13 @@ myst:
1313
# Overview
1414

1515
Plone is a mature, secure, and user-friendly content management system (CMS).
16-
Plone was first released to the public on October 4, 2001.
16+
Plone lets non-technical people create and maintain information for a public website or an intranet using only a web browser. Plone was first released to the public on October 4, 2001.
1717

1818
Plone has the maturity, stability, and reliability of an application maintained by open source developers with decades of experience, while continually evolving and adapting to modern technology.
1919

2020
Lots of customizations can be made trough-the-web, such as creating content types, themes, workflows, and much more.
2121
A full filesystem based development workflow is also possible.
22-
Plone may be extended and used as a framework on which to build custom CMS-like solutions.
22+
Plone can be extended and used as a framework on which to build custom CMS-like solutions.
2323

2424
Plone works as a:
2525

@@ -58,57 +58,60 @@ Plone is easy to set up compared to other CMS'es in its category, extremely flex
5858
In addition, Plone can be scripted using web standard solutions and open source languages.
5959

6060
- **Plone is technology neutral.**
61-
Plone can interoperate with most relational database systems—both open source and commercial—and runs on a vast array of
62-
platforms, including Linux, Windows, macOS, and BSD.
61+
Plone can interoperate with most relational database systems—both open source and commercial—and runs on a vast array of platforms, including Linux, Windows, macOS, and BSD.
6362

6463

6564

6665
(overview-4-label)=
6766

6867
## High Level Overview for Developers
6968

70-
Plone is a content management platform with its backend written in Python. The backend builds upon Zope, an open source web
71-
application server and development system, and thus on the pluggable Zope Component Architecture (ZCA). The frontend has up until version 6
72-
served HTML based content, with advanced resource management on the server to add and bundle CSS and javascript.
69+
Plone is a content management platform with its backend written in Python.
70+
The backend builds upon Zope, an open source web application server and development system, and thus on the pluggable Zope Component Architecture (ZCA).
71+
The backend has up until version 6 served HTML based content, with advanced resource management on the server to add and bundle CSS and javascript.
7372

7473
With the release of Plone 6 there are now two out of the box supported configurations possible for a new Plone website.
7574

7675
You can still use the Python based backend server to render the content server side and deliver html to the browser.
77-
This setup is referred to in the documentation as 'Classic UI' and has been supported by Plone since its release.
76+
This setup is referred to in the documentation as 'Classic UI' and has been supported by Plone since its release.
7877
For container based deployment you only need the plone-backend image, or a derivation with your customisations added.
79-
In the documentation
8078

8179
The default and advised configuration for new websites in Plone is to use our new React Based javascript frontend called 'Volto'.
8280
For this setup you still need to run the Python based backend server, but with the REST API enabled and an updated configuration profile.
8381
In addition a separate NodeJS based frontend server will serve the javascript frontend resources and provide SSR with hydration.
84-
To deploy this setup using containers you will need the plone-frontend image of the frontend server.
82+
To deploy this setup using containers you will need the plone-frontend image of the frontend server.
8583

86-
This is the first release of Plone where we support two programming language stacks, one for Python and Javascript.
87-
The documentation has been rewritten, but for this first release you will find some repetition of concepts in the documentation structure.
84+
Plone 6 is the version Plone where we support two programming language stacks, one for Python and Javascript.
85+
The documentation has been rewritten, but for this first release you will find some repetition of concepts in the documentation structure.
8886
For example for the development setup and information on deployment options.
8987
It will take some time before we find and can implement the best structure to explain these new possibilities and expansion of Plone its capabilities.
9088

89+
```{seealso}
90+
https://training.plone.org/mastering-plone/what_is_plone.html
91+
```
92+
9193

9294
(overview-5-label)=
9395
## Deployment
9496

95-
To run a public Plone website in production, you will also need to configure and run a reverse proxy (or ingress), arrange for SSL certificates (either from Lets Encrypt or manually), check persistenct of the content database and arrange for backups. This is the domain
96-
of sysadmins and modern devops. Our documentation contains setup examples for these services but requires also experience and knowledge.
97+
To run a public Plone website in production, you will also need to configure and run a reverse proxy (or ingress), arrange for SSL certificates (either from Let's Encrypt or manually), check persistenct of the content database and arrange for backups.
98+
This is the domain of sysadmins and modern devops.
99+
Our documentation contains setup examples for these services but requires also experience and knowledge.
97100

98101

99102
(overview-6-label)=
100103
## Good to know / What to know
101104

102-
One of the key benefits of the new React based frontend for Plone 6 is that you can now customise and theme Plone extensively using HTML and Javascript using up to date frontend technologies without having having to set up a local Python development environment.
105+
One of the key benefits of the new React based frontend for Plone 6 is that you can now customize and theme Plone extensively using HTML and Javascript using up to date frontend technologies without having having to set up a local Python development environment.
103106
The Plone backend can be run on a local developer machine in a container.
104107

105108
Basic familiarity with programming in Python and managing Python modules/packages using virtualenv and pip is required to work on the backend code.
106109
We use virtualenv and mxdev to manage the source installation of packages in Plone 6.
107110

108-
Similarly, to develop for the new React frontend, you need to have some experience with setting up NodeJS, using a tool like NVM (Node Version Manager) to isolate your setup, Yarn and React.
111+
Similarly, to develop for the new React frontend, you need to have some experience with setting up NodeJS, using a tool like NVM (Node Version Manager) to isolate your setup, Yarn and React.
109112

110-
If you are looking for more study material on these technologies and the documentation is too dense, see and follow one or more [Plone Trainings]](https://training.plone.org).
111-
Our trainings are more verbose and contain extra clarification and examples.
113+
If you are looking for more study material on these technologies and the documentation is too dense, see and follow one or more [Plone Trainings](https://training.plone.org).
114+
Our trainings are more verbose and contain extra clarification and examples.
112115

113116

114117
```{toctree}

0 commit comments

Comments
 (0)