Skip to content

Commit ba0e074

Browse files
committed
Tidy up add-site.md, mostly docs style guide stuff, and a rewording of the final admonition.
Add plural `distributions` to Glossary.
1 parent 28d42ec commit ba0e074

File tree

2 files changed

+18
-16
lines changed

2 files changed

+18
-16
lines changed

docs/glossary.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -802,6 +802,7 @@ reference implementation
802802
The reference implementation often accompanies a technical standard, and demonstrates what should be considered the "correct" behavior of any other implementation of it.
803803
804804
distribution
805+
distributions
805806
A Plone distribution is a pre-packaged version of Plone that includes specific features, themes, modules, and configurations.
806807
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.
807808

docs/install/add-site.md

Lines changed: 17 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -3,11 +3,11 @@ myst:
33
html_meta:
44
"description": "How to add a Plone site to an existing Zope instance"
55
"property=og:description": "How to add a Plone site to an existing Zope instance"
6-
"property=og:title": "Create a Plone site"
6+
"property=og:title": "Add a Plone site"
77
"keywords": "Plone 6, create, add, factory, distributions"
88
---
99

10-
% This should move into the Admin guide once https://github.com/plone/documentation/pull/1746 is merged.
10+
% TODO: This should move into the Admin guide once https://github.com/plone/documentation/pull/1746 is merged.
1111

1212
(add-a-plone-site-label)=
1313

@@ -17,19 +17,19 @@ This section explains how to add a Plone site to an existing Zope instance.
1717
It assumes that you have already {doc}`installed </install/index>` and started Plone.
1818

1919
Some installation methods create a Plone site for you already.
20-
Follow these instructions if you used an installation method that did not do this,
21-
or if you need a second Plone site in the same instance for some reason.
20+
Follow these instructions if you used an installation method that did not do this, or if you need a second Plone site in the same instance for some reason.
2221

2322
```{versionadded} Plone 6.1
2423
The user interface for creating a new Plone site was changed in Plone 6.1.
2524
You can access it the same way in Plone 6.0, but the appearance and options are different.
2625
```
2726

28-
Open the Plone backend. Usually it is running at http://localhost:8080/
27+
Visit the Plone backend in a web browser.
28+
Usually it is running at http://localhost:8080/
2929

30-
This launch screen prompts you to choose one of the available {term}`distributions <distribution>` to create a new site.
30+
The launch screen prompts you to choose one of the available {term}`distributions` to create a new site.
3131

32-
% add a link to choose-user-interface doc once https://github.com/plone/documentation/pull/1749 is merged
32+
% TODO: Add a link to the choose-user-interface doc once https://github.com/plone/documentation/pull/1749 is merged.
3333

3434
````{card}
3535
```{image} /backend/upgrading/version-specific-migration/images/distribution-chooser.png
@@ -42,14 +42,16 @@ _Launch screen for choosing a distribution_
4242

4343
Hover over your choice and click the {guilabel}`Create` button.
4444

45-
Now complete the form with initial configuration for your site. You can configure:
45+
Now complete the form with initial configuration for your site.
46+
You can configure the following settings.
4647

47-
:::{card}
4848
Path Identifier
49-
: The ID of the site. This ends up as part of the URL unless hidden by an upstream web server.
49+
: The ID of the site.
50+
This ends up as part of the URL unless hidden by an upstream web server.
5051

5152
Title
52-
: The name of the site in the HTML `title` element. This will be shown as part of the title of the browser tab on each page.
53+
: The name of the site in the HTML `title` element.
54+
This will be shown as part of the title of the browser tab on each page.
5355

5456
Site Description
5557
: A brief description that will be served in an HTML `meta` tag.
@@ -62,14 +64,13 @@ Language
6264

6365
Timezone
6466
: The default timezone setting of the portal.
65-
:::
6667

67-
Finally, press {guilabel}`Submit`.
68+
Finally, click the {guilabel}`Submit` button.
6869

6970
Have fun with your new Plone site!
7071

7172
```{important}
72-
If you are using the Volto frontend, keep in mind that the launch screen for adding a site is hosted by the Plone backend server.
73-
After you create the site, you must switch to Volto.
74-
Usually, it is running at http://localhost:3000.
73+
The launch screen for adding a site is hosted by the Plone backend server.
74+
Regardless of the frontend you select, you will be redirected to the backend's user interface after you create the site.
75+
If you select the Volto frontend, you can switch to it by changing the port number in the URL, usually `3000`, and visiting it at http://localhost:3000, for example.
7576
```

0 commit comments

Comments
 (0)