Skip to content

Commit e1f996f

Browse files
committed
Shorten explanations for version numbers
1 parent c90a7e7 commit e1f996f

File tree

1 file changed

+7
-12
lines changed

1 file changed

+7
-12
lines changed

docusaurus/docs/release-notes.md

Lines changed: 7 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -11,22 +11,17 @@ This page lists all the Strapi Docs version numbers and their corresponding upda
1111
<details>
1212
<summary>🧐 Strapi Docs version numbers explained:</summary>
1313

14-
The Strapi Documentation (or in short, Strapi Docs) hosted at docs.strapi.io is **always documenting the latest version of the Strapi (CMS and Cloud) products**.
14+
The **Strapi Documentation** (Strapi Docs) at [docs.strapi.io](https://docs.strapi.io) **always reflects the latest version of Strapi (CMS and Cloud)**.
1515

16-
Please note however, that, since Strapi Docs version 5.0.0, the documentation's package version number is decoupled from the Strapi product(s) version number. Version numbers of [`strapi/documentation`](https://github.com/strapi/documentation) and [`strapi/strapi`](https://github.com/strapi/strapi) might be different.
16+
Since Strapi Docs version 5.0.0, the **docs' version number is independent from the Strapi product version**. Thus, the version numbers of [`strapi/documentation`](https://github.com/strapi/documentation) and [`strapi/strapi`](https://github.com/strapi/strapi) may differ.
1717

18-
Strapi Docs now follow the [semantic versioning](https://semver.org/) philosophy, but adapted to docs:
18+
Strapi Docs now follow the **[semantic versioning](https://semver.org/)** philosophy, but adapted to docs:
1919

20-
* New **major version** number (6.0.0, 7.0.0…): **The documentation website is significantly rewritten** (either its content or the framework underlying it). When a new major docs version is released, the following might happen:
21-
* The reading experience might significantly change, including a complete redesign, a rework of the navigation and table of content, or a different way of grouping, presenting, and displaying pages and features.
22-
* Links used in the previous major version might be broken. This should however happen transparently as the Strapi Docs team will do its best to handle previous links with redirections. If you find broken links, please feel free to [report an issue](https://github.com/strapi/documentation/issues/new/choose).
23-
* The present website is based on [Docusaurus](https://docusaurus.io), but Docusaurus upgrades (including new major versions) will generally not trigger a new major Strapi Docs version number, unless such upgrades require rewriting the whole website in a way that would qualify it for a new major version number.
24-
* New **minor version** number (5.1.0, 5.2.0…): **New Strapi features are documented**, or small, quality-of-life-related documentation features (such as new components or new tools) are added or updated.
25-
* New **patch version** number (5.1.1, 5.1.2…): **Existing documentation content is updated**. This includes fixes, typos, and updates to already documented Strapi features.
20+
- **Major version** (6.0.0, 7.0.0…): A **significant rewrite** of the docs (content or framework). This may impact the user experience, redesign the site, or break old links (redirections are handled, but broken links can be [reported](https://github.com/strapi/documentation/issues/new/choose)).
21+
- **Minor version** (5.1.0, 5.2.0…): **New Strapi features or improvements** to the docs (e.g., new components or tools).
22+
- **Patch version** (5.1.1, 5.1.2…): **Content updates**, incl. such as fixes or typos.
2623

27-
The highest number will take precedence, meaning that if a weekly release includes both patch version-type and minor version-type updates, a new minor version is released.
28-
29-
New minor or patch version numbers are released weekly, usually on Wednesdays.
24+
New versions (minor or patch) are generally released weekly, on Wednesdays.
3025

3126
</details>
3227

0 commit comments

Comments
 (0)