Skip to content

Commit 93e14ab

Browse files
Merge pull request #1980 from strapi/user/releases-stable-updates
Updates for the stable version of Releases
2 parents 88ccc4a + bfdf9b3 commit 93e14ab

File tree

7 files changed

+23
-24
lines changed

7 files changed

+23
-24
lines changed

docusaurus/docs/dev-docs/configurations.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ Some specific features require additional configuration:
4343
| [Cron jobs](/dev-docs/configurations/cron) | <ul><li>In the `/config/server` file to enable the feature</li><li>In a dedicated, optional `cron-tasks` file that can be used to declare the jobs</li></ul> | Required to setup CRON jobs for the server. |
4444
| [Environment variables](/dev-docs/configurations/environment) | In dedicated files and folders for the environment (e.g., `config/env/production/server`) | Optionally used to define different environments and their variables. |
4545
| [Single Sign-On (SSO)](/dev-docs/configurations/sso) <EnterpriseBadge /> | In the `config/admin` file | Required to use the Entreprise-only SSO feature if enabled on your project. |
46-
| [Feature flags](/dev-docs/configurations/features) | In the `config/features` file | Optional for a typical, stable Strapi application.<br/>Only required to enable [future flags](/dev-docs/configurations/features).|
46+
<!-- | [Feature flags](/dev-docs/configurations/features) | In the `config/features` file | Optional for a typical, stable Strapi application.<br/>Only required to enable [future flags](/dev-docs/configurations/features).| -->
4747

4848
## Guides
4949

docusaurus/docs/user-docs/content-manager/adding-content-to-releases.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Instructions to include content in a release
44
displayed_sidebar: userDocsSidebar
55
---
66

7-
# Including content in a release <EnterpriseBadge /> <CloudTeamBadge /> <FutureBadge /> <BetaBadge />
7+
# Including content in a release <EnterpriseBadge /> <CloudTeamBadge />
88

99
Using the [Releases](/user-docs/releases/introduction) feature, you can group several entries to publish them altogether. Adding entries to a release is done from the Content Manager. You can also remove an entry from a release while updating the entry.
1010

@@ -35,17 +35,17 @@ To add entries to a release:
3535
}}
3636
/>
3737

38-
## Adding a single entry to a release
38+
## Adding an entry to a release
3939

40-
An entry can be added to a [release](/user-docs/releases/introduction) while editing it from the edit view of the Content Manager.
40+
An entry can be added to a [release](/user-docs/releases/introduction) while editing it from the edit view of the Content Manager. Only collection type entries can be added to a release, not single type entries.
4141

4242
To add an entry to a release:
4343

4444
1. In the Releases box in the right sidebar, click the **+ Add to release** button.
4545
2. Select which release to add this entry to.
4646
3. Decide whether the entry will be published or unpublished when the release itself is published, then click **Continue**.
4747

48-
## Removing a single entry from a release
48+
## Removing an entry from a release
4949

5050
An entry can be removed from a [release](/user-docs/releases/introduction) while editing it from the edit view of the Content Manager.
5151

docusaurus/docs/user-docs/releases/creating-a-release.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Creating a release
33
description: Instructions to create a release from the admin panel
44
---
55

6-
# Creating a release <EnterpriseBadge /> <CloudTeamBadge /> <FutureBadge /> <BetaBadge />
6+
# Creating a release <EnterpriseBadge /> <CloudTeamBadge />
77

88
The [Releases](/user-docs/releases/introduction) page allows creating new releases that will be used to organize entries.
99

@@ -26,7 +26,7 @@ To create a new release:
2626

2727
Adding entries to a release must be done from the Content Manager. You can add a single entry to a release while creating or editing the entry [in the edit view](/user-docs/content-manager/adding-content-to-releases).
2828

29-
<!-- TODO: for later, when multiple addition is implemented -->
29+
<!-- TODO: for later, when multiple addition is implemented, probably in 4.20 -->
3030
<!--
3131
Adding entries to a release must be done from the Content Manager:
3232

docusaurus/docs/user-docs/releases/introduction.md

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,13 +3,10 @@ title: Introduction to Releases
33
description: Introduction to the Releases feature that enables content managers to organize entries to publish/unpublish simultaneously
44
---
55

6-
# Releases <EnterpriseBadge /> <CloudTeamBadge/> <FutureBadge /> <BetaBadge/>
6+
# Releases <EnterpriseBadge /> <CloudTeamBadge/>
77

88
Releases enables content managers to organize entries into containers that can perform publish and unpublish actions simultaneously. A release can contain entries from different content types and can mix locales.
99

10-
11-
Releases is currently only available as an experimental feature. To enable it, set the appropriate future flag. See <a href="/dev-docs/configurations/features">future flags</a> documentation for instructions on how to enable a future flag.
12-
1310
<ThemedImage
1411
alt="List of Releases"
1512
sources={{

docusaurus/docs/user-docs/releases/managing-a-release.md

Lines changed: 13 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Instructions on how to manage a Release from the admin panel
44
---
55

66

7-
# Managing a release <EnterpriseBadge /> <CloudTeamBadge /> <FutureBadge /> <BetaBadge />
7+
# Managing a release <EnterpriseBadge /> <CloudTeamBadge />
88

99
Adding entries to a [release](/user-docs/releases/introduction) allow viewing them altogether on a single page.
1010

@@ -36,28 +36,30 @@ You can rename a release. To do so, while on a release page:
3636
3. In the modal, change the name of the release in the _Name_ field.
3737
4. Click **Continue** to save the change.
3838

39-
## Choose how entries are grouped
40-
41-
:::callout 🚧 Beta feature
42-
Use the following command to install the latest version of this feature:
43-
`npx create-strapi-app@beta`
44-
:::
39+
## Choosing how entries are grouped
4540

4641
A release page can display entries either grouped by locale, content-type, or action (publish or unpublish). To change how entries are grouped, click the **Group by …** dropdown and select an option from the list.
4742

48-
## Publish or unpublish entries
43+
## Publishing or unpublishing entries
4944

5045
A release includes multiple entries. You can set the state of each entry with the **Publish** and **Unpublish** action buttons. When the release itself is “published” then the desired actions will be simultaneously performed on each entry.
5146

52-
<!-- TODO: re-add when implemented -->
53-
<!-- ## Remove entries from a release
47+
## Removing entries from a release
5448

55-
Entries can be removed from a release. To do so, click the three dots **…** at the end of the line of an entry and select the **Remove from release** button. -->
49+
Entries can be removed from a release. To do so, click the ![More icon](/img/assets/icons/more.svg) at the end of the line of an entry and select the **Remove from release** button.
5650

5751
## Publishing a release
5852

5953
Publishing a release means that all the actions (publish or unpublish) defined for each entry included in the release will be performed simultaneously. To publish a release, click the **Publish** button in the top right corner of the admin panel.
6054

55+
The _Status_ column displays the status of each entry:
56+
57+
- ![Success icon](/img/assets/icons/CheckCircle.svg) Already published: the entry is already published and publishing the release will not affect this entry
58+
- ![Success icon](/img/assets/icons/CheckCircle.svg) Ready to publish: the entry is ready to be published with the release
59+
- ![Fail icon](/img/assets/icons/CrossCircle.svg) "[field name] is required", "[field name] is too short" or "[field name] is too long": the entry cannot be published because of the issue stated in the red warning message.
60+
61+
If some of your entries have a ![Fail icon](/img/assets/icons/CrossCircle.svg) status, click the ![More icon](/img/assets/icons/more.svg) and the **Edit the entry** button to fix the issues until all entries have the ![Success icon](/img/assets/icons/CheckCircle.svg) status. Note that you will have to click on the **Refresh** button to update the release page as you fix the various entries issues.
62+
6163
:::caution
6264
Once a release is published, the release itself cannot be updated. You can not re-release that specific release with the same group of entries with some modifications; you must create another release.
6365
:::

docusaurus/sidebars.js

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -83,7 +83,7 @@ const sidebars = {
8383
'dev-docs/configurations/public-assets',
8484
'dev-docs/configurations/sso',
8585
'dev-docs/configurations/rbac',
86-
'dev-docs/configurations/features',
86+
// 'dev-docs/configurations/features',
8787
],
8888
},
8989
{

docusaurus/src/components/ProjectStructureConfigFiles.js

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ export default function InteractiveProjectStructure() {
1111
│ ├ <a href="/dev-docs/configurations/admin-panel">admin.js|ts</a><br/>
1212
│ ├ <a href="/dev-docs/configurations/cron">cron-tasks.js|ts</a><br/>
1313
│ ├ <a href="/dev-docs/configurations/database#database-configuration">database.js|ts</a><br/>
14-
│ ├ <a href="/dev-docs/configurations/features">features.js|ts</a><br/>
14+
{/* │ ├ <a href="/dev-docs/configurations/features">features.js|ts</a><br/> */}
1515
│ ├ <a href="/dev-docs/configurations/middlewares">middlewares.js|ts</a><br/>
1616
│ ├ <a href="/dev-docs/configurations/plugins">plugins.js|ts</a><br/>
1717
│ └ <a href="/dev-docs/configurations/server#server-configuration">server.js|ts</a><br/>

0 commit comments

Comments
 (0)