Skip to content

Commit c90a7e7

Browse files
committed
Update release notes with explanations and 5.1.0
1 parent e094fa7 commit c90a7e7

File tree

1 file changed

+86
-0
lines changed

1 file changed

+86
-0
lines changed

docusaurus/docs/release-notes.md

Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,92 @@ custom_edit_url: null
66

77
<div className="release-notes-page">
88

9+
This page lists all the Strapi Docs version numbers and their corresponding updates.
10+
11+
<details>
12+
<summary>🧐 Strapi Docs version numbers explained:</summary>
13+
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**.
15+
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.
17+
18+
Strapi Docs now follow the [semantic versioning](https://semver.org/) philosophy, but adapted to docs:
19+
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.
26+
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.
30+
31+
</details>
32+
33+
## 5.1.0
34+
35+
### ✨ New content
36+
37+
#### Cloud Docs
38+
39+
* [Multi-Environments](https://github.com/strapi/documentation/pull/2229)
40+
41+
### 🖌 Updated content
42+
43+
#### User Guide
44+
45+
* [Mention Blocked status for Releases](https://github.com/strapi/documentation/pull/2235)
46+
47+
#### Dev Docs
48+
49+
* [Clarify helper-plugin migration guide](https://github.com/strapi/documentation/pull/2230)
50+
51+
### 🧹 Chore, fixes, typos, and other improvements
52+
53+
#### Dev Docs
54+
55+
* [Fix creating a custom provider example](https://github.com/strapi/documentation/pull/2237)
56+
* [Fix pagination_next for first page of categories](https://github.com/strapi/documentation/pull/2234)
57+
* [Fix SEO issues](https://github.com/strapi/documentation/pull/2233)
58+
* [Fix links to strapi codebase](https://github.com/strapi/documentation/pull/2226)
59+
* [Fix code example in general deployment guidelines](https://github.com/strapi/documentation/pull/2231)
60+
* [Fix grammar in TypeScript development docs](https://github.com/strapi/documentation/pull/2232)
61+
62+
***
63+
64+
This release was made possible thanks to the following contributors. Thank you! 🫶
65+
66+
<div>
67+
68+
<a href="https://github.com/ChristopheCVB" target="_blank">
69+
<img className="no-zoom" src="https://avatars.githubusercontent.com/u/946345?v=4" width="40" height="40" style={{borderRadius: '50%'}} alt="ChristopheCVB"/>
70+
</a>
71+
<a href="https://github.com/imcarlosguerrero" target="_blank">
72+
<img className="no-zoom" src="https://avatars.githubusercontent.com/u/173419460?v=4" width="40" height="40" style={{borderRadius: '50%'}} alt="imcarlosguerrero"/>
73+
</a>
74+
<a href="https://github.com/stefanhuber" target="_blank">
75+
<img className="no-zoom" src="https://avatars.githubusercontent.com/u/5379359?v=4" width="40" height="40" style={{borderRadius: '50%'}} alt="stefanhuber"/>
76+
</a>
77+
<a href="https://github.com/butcherZ" target="_blank">
78+
<img className="no-zoom" src="https://avatars.githubusercontent.com/u/8189028?v=4" width="40" height="40" style={{borderRadius: '50%'}} alt="butcherZ"/>
79+
</a>
80+
<a href="https://github.com/jhoward1994" target="_blank">
81+
<img className="no-zoom" src="https://avatars.githubusercontent.com/u/48524071?v=4" width="40" height="40" style={{borderRadius: '50%'}} alt="jhoward1994"/>
82+
</a>
83+
<a href="https://github.com/meganelacheny" target="_blank">
84+
<img className="no-zoom" src="https://avatars.githubusercontent.com/u/19183360?v=4" width="40" height="40" style={{borderRadius: '50%'}} alt="meganelacheny"/>
85+
</a>
86+
<a href="https://github.com/pwizla" target="_blank">
87+
<img className="no-zoom" src="https://avatars.githubusercontent.com/u/4233866?v=4" width="40" height="40" style={{borderRadius: '50%'}} alt="pwizla"/>
88+
</a>
89+
90+
</div>
91+
92+
<br/>
93+
<br/>
94+
995
## 5.0.0
1096

1197
_The following is an extensive list of all the pull requests that were merged since we started working on Strapi 5 documentation. For a quicker tour, please refer to the [What's new page](/dev-docs/whats-new)._

0 commit comments

Comments
 (0)