🚀 Production release 4.2.2

.github/ISSUE_TEMPLATE/BUG_REPORT.yml

@@ -1,7 +1,7 @@
 name: Documentation Bug Report
 description: Create a report to help us improve the Strapi documentation.
 title: "[Bug]: "
-labels: "type: bug, status: pending reproduction"
+labels: "type: bug"
 body:
   - type: input
     attributes:

CONTRIBUTING.md

@@ -96,7 +96,28 @@ Follow the procedure below to contribute to the Strapi documentation.
     git checkout -b <user/branch-name>
 
     ```
-
+
+7. Run the docs on your computer
+
+  ```bash
+    cd docs
+
+    # Install dependencies
+    yarn
+
+    # Run user and developer-docs
+    yarn dev
+
+    # Run developer-docs only
+    yarn dev:dev
+
+    # Run user-docs only
+    yarn dev:user
+
+  ```
+
+  The project is now up and running at http://localhost:8080 and you should be able to access it in your browser.
+
 
 You are now ready to contribute to the Strapi documentation! 🚀
 

docs/.vuepress/config/sidebar-developer.js

@@ -240,10 +240,12 @@ const developer = [
             path: '/developer-docs/latest/developer-resources/database-apis-reference/rest-api.html',
             collapsable: true,
             initialOpenGroupIndex: -1,
-            // sidebarDepth: 3,
+            sidebarDepth: 3,
             children: [
+              ['/developer-docs/latest/developer-resources/database-apis-reference/rest-api.html', 'API endpoints'],
               {
-                title: 'API Parameters',
+                title: 'API parameters',
+                path: '/developer-docs/latest/developer-resources/database-apis-reference/rest/api-parameters.html',
                 collapsable: true,
                 initialOpenGroupIndex: -1,
                 children: [
@@ -261,10 +263,6 @@ const developer = [
                   ],
                 ]
               },
-              [
-                '/developer-docs/latest/developer-resources/database-apis-reference/rest-api.html',
-                'API Endpoints'
-              ]
             ],
           },
           [

docs/.vuepress/styles/strapi-custom-blocks.styl

@@ -96,6 +96,10 @@
       color: rgba(241,251,255,.8)
     p
       padding-left: 1rem
+      code
+      /* Chrome version 29 and above */
+        @media screen and (-webkit-min-device-pixel-ratio:0) and (min-resolution:.001dpcm)
+          word-break: break-word
     ul, ol
       padding-left: 3rem
     [class^="language-"]

docs/developer-docs/latest/developer-resources/cli/CLI.md

@@ -334,6 +334,22 @@ options [--delete-files]
 Some plugins have admin panel integrations, your admin panel might have to be rebuilt. This can take some time.
 :::
 
+## strapi telemetry:disable
+
+Disable data collection for the project (see [Usage Information](/developer-docs/latest/getting-started/usage-information.md)).
+
+```bash
+strapi telemetry:disable
+```
+
+## strapi telemetry:enable
+
+Re-enable data collection for the project after it was disabled (see [Usage Information](/developer-docs/latest/getting-started/usage-information.md)).
+
+```bash
+strapi telemetry:enable
+```
+
 ## strapi console
 
 Start the server and eval commands in your application in real time.

docs/developer-docs/latest/developer-resources/content-api/integrations.md

@@ -16,7 +16,7 @@ In case you want to connect a React application with Strapi, we say that React i
 
 If your Strapi application contains restaurants and you want to list them in your React application, all you need to do is to make an HTTP request to Strapi which will take care to give you a response containing your restaurants.
 
-The [API Endpoints](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#api-endpoints) documentation will give you all the keys in hand to interact with your Strapi API.
+The [API Endpoints](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#endpoints) documentation will give you all the keys in hand to interact with your Strapi API.
 
 ## Get started
 

docs/developer-docs/latest/developer-resources/content-api/integrations/dart.md

@@ -316,4 +316,4 @@ void main() {
 
 ## Conclusion
 
-Here is how to request your collection types in Strapi using Dart. When you create a collection type or a single type you will have a certain number of [REST API endpoints](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#api-endpoints) available to interact with.
+Here is how to request your collection types in Strapi using Dart. When you create a collection type or a single type you will have a certain number of [REST API endpoints](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#endpoints) available to interact with.

docs/developer-docs/latest/developer-resources/content-api/integrations/flutter.md

@@ -217,4 +217,4 @@ var response = await http.put(
 
 ## Conclusion
 
-Here is how to request your collection types in Strapi using Dart/Flutter. When you create a collections type or a single type you will have a certain number of [REST API endpoints](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#api-endpoints) available to interact with.
+Here is how to request your collection types in Strapi using Dart/Flutter. When you create a collections type or a single type you will have a certain number of [REST API endpoints](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#endpoints) available to interact with.

docs/developer-docs/latest/developer-resources/content-api/integrations/go.md

@@ -318,4 +318,4 @@ func putD() {
 
 Here is how to request your collection types in Strapi using Go. When you create a collection type or a single type you will have a certain number of REST API endpoints available to interact with.
 
-We just used the GET, POST and PUT methods here but you can [get one entry](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#get-an-entry), and [delete](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#delete-an-entry) an entry too. Learn more about [API Endpoints](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#api-endpoints).
+We just used the GET, POST and PUT methods here but you can [get one entry](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#get-an-entry), and [delete](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#delete-an-entry) an entry too. Learn more about [API Endpoints](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#endpoints).

docs/developer-docs/latest/developer-resources/content-api/integrations/next-js.md

@@ -640,4 +640,4 @@ fetch('http://localhost:1337/api/restaurants/2', {
 
 Here is how to request your collection types in Strapi using Next.js. When you create a collection type or a single type you will have a certain number of REST API endpoints available to interact with.
 
-We just used the GET, POST and PUT methods here but you can [get one entry](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#get-an-entry), and [delete](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#delete-an-entry) an entry too. Learn more about [API Endpoints](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#api-endpoints).
+We just used the GET, POST and PUT methods here but you can [get one entry](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#get-an-entry), and [delete](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#delete-an-entry) an entry too. Learn more about [API Endpoints](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#endpoints).

docs/developer-docs/latest/developer-resources/content-api/integrations/nuxt-js.md

@@ -780,4 +780,4 @@ fetch('http://localhost:1337/api/restaurants/2', {
 
 Here is how to request your collection types in Strapi using Nuxt.js. When you create a collection type or a single type you will have a certain number of REST API endpoints available to interact with.
 
-We just used the GET, POST and PUT methods here but you can [get one entry](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#get-an-entry),  and [delete](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#delete-an-entry) an entry too. Learn more about [API Endpoints](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#api-endpoints).
+We just used the GET, POST and PUT methods here but you can [get one entry](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#get-an-entry),  and [delete](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#delete-an-entry) an entry too. Learn more about [API Endpoints](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#endpoints).

docs/developer-docs/latest/developer-resources/content-api/integrations/php.md

@@ -442,4 +442,4 @@ postRestaurantWithAuth($jwt);
 
 Here is how to request your collection types in Strapi using PHP. When you create a collection type or a single type you will have a certain number of REST API endpoints available to interact with.
 
-We just used the GET, POST and PUT methods here but you can [get one entry](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#get-an-entry), and [delete](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#delete-an-entry) an entry too. Learn more about [API Endpoints](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#api-endpoints).
+We just used the GET, POST and PUT methods here but you can [get one entry](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#get-an-entry), and [delete](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#delete-an-entry) an entry too. Learn more about [API Endpoints](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#endpoints).

docs/developer-docs/latest/developer-resources/content-api/integrations/react.md

@@ -639,4 +639,4 @@ fetch('http://localhost:1337/api/restaurants/2', {
 
 Here is how to request your collection types in Strapi using React. When you create a collection type or a single type you will have a certain number of REST API endpoints available to interact with.
 
-We just used the GET, POST and PUT methods here but you can [get one entry](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#get-an-entry), and [delete](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#delete-an-entry) an entry too. Learn more about [API Endpoints](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#api-endpoints).
+We just used the GET, POST and PUT methods here but you can [get one entry](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#get-an-entry), and [delete](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#delete-an-entry) an entry too. Learn more about [API Endpoints](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#endpoints).

docs/developer-docs/latest/developer-resources/content-api/integrations/vue-js.md

@@ -582,4 +582,4 @@ fetch('http://localhost:1337/api/restaurants/2', {
 
 Here is how to request your collection types in Strapi using Vue.js. When you create a collection type or a single type you will have a certain number of REST API endpoints available to interact with.
 
-We just used the GET, POST and PUT methods here but you can [get one entry](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#get-an-entry), and [delete](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#delete-an-entry) an entry too. Learn more about [API Endpoints](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#api-endpoints).
+We just used the GET, POST and PUT methods here but you can [get one entry](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#get-an-entry), and [delete](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#delete-an-entry) an entry too. Learn more about [API Endpoints](/developer-docs/latest/developer-resources/database-apis-reference/rest-api.md#endpoints).

docs/developer-docs/latest/developer-resources/database-apis-reference/entity-service-api.md

@@ -8,6 +8,10 @@ canonicalUrl: https://docs.strapi.io/developer-docs/latest/developer-resources/d
 
 Strapi provides an Entity Service API, built on top of the [Query Engine API](/developer-docs/latest/developer-resources/database-apis-reference/query-engine-api.md). The Entity Service is the layer that handles Strapi's complex data structures like [components](/developer-docs/latest/development/backend-customization/models.md#components) and [dynamic zones](/developer-docs/latest/development/backend-customization/models.md#dynamic-zones), and uses the Query Engine API under the hood to execute database queries.
 
+::: strapi Entity Service API vs. Query Engine API
+!!!include(developer-docs/latest/developer-resources/database-apis-reference/snippets/entity-query-knex-callout.md)!!!
+:::
+
 ## Basic usage
 
 The Entity Service is available through `strapi.entityService`:

docs/developer-docs/latest/developer-resources/database-apis-reference/query-engine-api.md

@@ -6,9 +6,11 @@ canonicalUrl: https://docs.strapi.io/developer-docs/latest/developer-resources/d
 
 # Query Engine API
 
-Strapi provides a Query Engine API to interact with the database layer at a lower level. It should mostly be used by plugin developers and developers adding custom business logic to their applications.
+Strapi provides a Query Engine API to interact with the database layer at a lower level. It should mostly be used by plugin developers and developers adding custom business logic to their applications. In most use cases, it's recommended to use the [Entity Service API](/developer-docs/latest/developer-resources/database-apis-reference/entity-service-api.md) instead.
 
-Strapi's Query Engine API gives unrestricted internal access to the database layer. It is not aware of the complex data structures like components and dynamic zones, as opposed to the [Entity Service API](/developer-docs/latest/developer-resources/database-apis-reference/entity-service-api.md).
+::: strapi Entity Service API vs. Query Engine API
+!!!include(developer-docs/latest/developer-resources/database-apis-reference/snippets/entity-query-knex-callout.md)!!!
+:::
 
 ## Basic usage