[v4] next-3 release

docs/.vuepress/config.js

@@ -50,14 +50,16 @@ const sidebar = {
               children: [
                 ['/developer-docs/latest/setup-deployment-guides/configurations/required/databases.md', 'Database'],
                 ['/developer-docs/latest/setup-deployment-guides/configurations/required/server.md', 'Server'],
+                ['/developer-docs/latest/setup-deployment-guides/configurations/required/admin-panel.md', 'Admin panel'],
+                ['/developer-docs/latest/setup-deployment-guides/configurations/required/middlewares.md', 'Middlewares'],
               ]
             },
             {
               title: 'Optional configurations',
               collapsable: true,
               children: [
-                ['/developer-docs/latest/setup-deployment-guides/configurations/optional/middlewares.md', 'Middlewares'],
                 ['/developer-docs/latest/setup-deployment-guides/configurations/optional/functions.md', 'Functions'],
+                ['/developer-docs/latest/setup-deployment-guides/configurations/optional/cronjobs.md', 'Cron jobs'],
                 ['/developer-docs/latest/setup-deployment-guides/configurations/optional/api.md', 'API'],
                 ['/developer-docs/latest/setup-deployment-guides/configurations/optional/plugins.md', 'Plugins'],
                 ['/developer-docs/latest/setup-deployment-guides/configurations/optional/environment.md', 'Environment'],
@@ -149,11 +151,13 @@ const sidebar = {
       initialOpenGroupIndex: -1, // make sure that no subgroup is expanded by default
       children: [
         {
-          title: 'Backend customization',
+          title: 'Back-end customization',
           collapsable: true,
+          path: '/developer-docs/latest/development/backend-customization',
           children: [
-            ['/developer-docs/latest/development/backend-customization/routing.md', 'Routing'],
+            ['/developer-docs/latest/development/backend-customization/routes.md', 'Routes'],
             ['/developer-docs/latest/development/backend-customization/policies.md', 'Policies'],
+            ['/developer-docs/latest/development/backend-customization/middlewares.md', 'Middlewares'],
             ['/developer-docs/latest/development/backend-customization/controllers.md', 'Controllers'],
             ['/developer-docs/latest/development/backend-customization/requests-responses.md', 'Requests & Responses'],
             ['/developer-docs/latest/development/backend-customization/services.md', 'Services'],
@@ -334,15 +338,15 @@ const sidebar = {
           ]
         },
         ['/developer-docs/latest/developer-resources/cli/CLI', 'Command Line Interface'],
+        ['/developer-docs/latest/developer-resources/error-handling.md', 'Error handling'],
       ],
     },
     {
       title: '📚 Guides',
       collapsable: true,
       children: [
-        ['/developer-docs/latest/guides/api-token', 'API tokens'],
         ['/developer-docs/latest/guides/auth-request', 'Authenticated request'],
-        ['/developer-docs/latest/guides/count-graphql', 'Count with GraphQL'],
+        // ['/developer-docs/latest/guides/count-graphql', 'Count with GraphQL'],
         ['/developer-docs/latest/guides/slug', 'Create a slug system'],
         ['/developer-docs/latest/guides/is-owner', 'Create is owner policy'],
         ['/developer-docs/latest/guides/custom-admin', 'Custom admin'],

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

@@ -95,6 +95,15 @@ options: [--no-optimization]
 - **strapi build --no-optimization**<br/>
   Builds the administration panel without minimizing the assets. The build duration is faster.
 
+## strapi watch-admin
+
+Starts the admin server.  Strapi should already be running with `strapi develop`.
+
+```sh
+strapi watch-admin
+options: [--browser <name>]
+```
+
 ## strapi configuration:dump
 
 **Alias**: `config:dump`
@@ -183,181 +192,75 @@ strapi admin:reset-user-password --email=chef@strapi.io --password=Gourmet1234
 | -p, --password | string | New password for the user |
 | -h, --help     |        | display help for command  |
 
-## strapi generate:api
+## strapi generate
 
-Scaffold a complete API with its configurations, controller, model and service.
+Run a fully interactive CLI to generate APIs, [controllers](/developer-docs/latest/development/backend-customization/controllers.md), [content-types](/developer-docs/latest/development/backend-customization/models.md), [plugins](/developer-docs/latest/development/plugins-development.md#creating-a-plugin), [policies](/developer-docs/latest/development/backend-customization/policies.md), [middlewares](/developer-docs/latest/development/backend-customization/middlewares.md) and [services](/developer-docs/latest/development/backend-customization/services.md).
 
-```bash
-strapi generate:api <name> [<attribute:type>]
-
-options: [--plugin <name>]
+```sh
+strapi generate
 ```
 
-- **strapi generate:api &#60;name&#62;**<br/>
-  Generates an API called **&#60;name&#62;** in the `./api` folder at the root of your project.
-
-- **strapi generate:api &#60;name&#62; --draft-and-publish=true**<br/>
-  Generates an API called **&#60;name&#62;** in the `./api` folder at the root of your project and enabled the draft/publish feature.
-
-- **strapi generate:api &#60;name&#62; &#60;attribute:type&#62;**<br/>
-  Generates an API called **&#60;name&#62;** in the `./api` folder at the root of your project. The model will already contain an attribute called **&#60;attribute&#62;** with the type property set to **&#60;type&#62;**.
+## strapi templates:generate
 
-  Example: `strapi generate:api product name:string description:text price:integer`
-
-- **strapi generate:api &#60;name&#62; --plugin &#60;plugin&#62;**<br/>
-  Generates an API called **&#60;name&#62;** in the `./plugins/<plugin>` folder.
-
-  Example: `strapi generate:api product --plugin content-manager`
-
-::: tip TIPS
-* The filename will be kebab-cased.
-* When you create a new API using the CLI, a model is automatically created.
-:::
-
-## strapi generate:controller
-
-Create a new controller.
+Create a template from the current strapi project
 
 ```bash
-strapi generate:controller <name>
-
-options: [--api <name>|--plugin <name>]
+strapi templates:generate <path>
 ```
 
-- **strapi generate:controller &#60;name&#62;**<br/>
-  Generates an empty controller called **&#60;name&#62;** in the `./api/<name>/controllers` folder.
-
-  Example: `strapi generate:controller category` will create the controller at `./api/category/controllers/Category.js`.
-
-- **strapi generate:controller &#60;name&#62; --api &#60;api&#62;**<br/>
-  Generates an empty controller called **&#60;name&#62;** in the `./api/<api>/controllers` folder.
-
-  Example: `strapi generate:controller category --api product` will create the controller at `./api/product/controllers/Category.js`.
-
-- **strapi generate:controller &#60;name&#62; --plugin &#60;plugin&#62;**<br/>
-  Generates an empty controller called **&#60;name&#62;** in the `./plugins/<plugin>/controllers` folder.
+- **strapi templates:generate &#60;path&#62;**<br/>
+  Generates a Strapi template at `<path>`
 
-::: tip
-The first letter of the filename will be uppercase.
-:::
+  Example: `strapi templates:generate ../strapi-template-name` will copy the required files and folders to a `template` directory inside `../strapi-template-name`
 
-## strapi generate:model
+## strapi routes:list
 
-Create a new model.
+Display a list of all the available [routes](/developer-docs/latest/development/backend-customization/routes.md).
 
-```bash
-strapi generate:model <name> [<attribute:type>]
-
-options: [--api <name>|--plugin <name>|--draft-and-publish <boolean>]
+```sh
+strapi routes:list
 ```
 
-- **strapi generate:model &#60;name&#62;**<br/>
-  Generates an empty model called **&#60;name&#62;** in the `./api/<name>/models` folder. It will create two files.
-  The first one will be **&#60;name&#62;.js** which contains your lifecycle callbacks and another **&#60;name&#62;.settings.json** that will list your attributes and options.
-
-  Example: `strapi generate:model category` will create these two files `./api/category/models/Category.js` and `./api/category/models/Category.settings.json`.
-
-- **strapi generate:model &#60;name&#62; &#60;attribute:type&#62;**<br/>
-  Generates an empty model called **&#60;name&#62;** in the `./api/<name>/models` folder. The file **&#60;name&#62;.settings.json** will already contain a list of attribute with their associated **&#60;type&#62;**.
-
-  Example: `strapi generate:model category name:string description:text` will create these two files `./api/category/models/Category.js` and `./api/category/models/Category.settings.json`. This last file will contain two attributes `name` with the type `string` and `description` with type `text`.
-
-- **strapi generate:model &#60;name&#62; --api &#60;api&#62;**<br/>
-  Generates an empty model called **&#60;name&#62;** in the `./api/<api>/models` folder.
-
-  Example: `strapi generate:model category --api product` will create these two files:
-
-  - `./api/product/models/Category.js`
-  - `./api/product/models/Category.settings.json`.
+## strapi policies:list
 
-* **strapi generate:model &#60;name&#62; --plugin &#60;plugin&#62;**<br/>
-  Generates an empty model called **&#60;name&#62;** in the `./plugins/<plugin>/models` folder.
+Display a list of all the registered [policies](/developer-docs/latest/development/backend-customization/policies.md).
 
-* **strapi generate:model &#60;name&#62; --draft-and-publish=true**<br/>
-  Generates an empty model called **&#60;name&#62;** in the `./plugins/<plugin>/models` folder with the draft/publish feature enabled
-
-::: tip
-The first letter of the filename will be uppercase.
-:::
-
-## strapi generate:service
-
-Create a new service.
-
-```bash
-strapi generate:service <name>
-
-options: [--api <name>|--plugin <name>]
+```sh
+strapi policies:list
 ```
 
-- **strapi generate:service &#60;name&#62;**<br/>
-  Generates an empty service called **&#60;name&#62;** in the `./api/<name>/services` folder.
-
-  Example: `strapi generate:service category` will create the service at `./api/category/services/Category.js`.
+## strapi middlewares:list
 
-- **strapi generate:service &#60;name&#62; --api &#60;api&#62;**<br/>
-  Generates an empty service called **&#60;name&#62;** in the `./api/<api>/services` folder.
+Display a list of all the registered [middlewares](/developer-docs/latest/development/backend-customization/middlewares.md).
 
-  Example: `strapi generate:service category --api product` will create the service at `./api/product/services/Category.js`.
-
-- **strapi generate:service &#60;name&#62; --plugin &#60;plugin&#62;**<br/>
-  Generates an empty service called **&#60;name&#62;** in the `./plugins/<plugin>/services` folder.
-
-::: tip
-The first letter of the filename will be uppercase.
-:::
-
-## strapi generate:policy
-
-Create a new policy.
-
-```bash
-strapi generate:policy <name>
-
-options: [--api <name>|--plugin <name>]
+```sh
+strapi middlewares:list
 ```
 
-- **strapi generate:policy &#60;name&#62;**<br/>
-  Generates an empty policy called **&#60;name&#62;** in the `./config/policies` folder.
-
-  Example: `strapi generate:policy isAuthenticated` will create the policy at `./config/policies/isAuthenticated.js`.
-
-- **strapi generate:policy &#60;name&#62; --api &#60;api&#62;**<br/>
-  Generates an empty policy called **&#60;name&#62;** in the `./api/<api>/config/policies` folder. This policy will be scoped and only accessible by the **&#60;api&#62;** routes.
-
-  Example: `strapi generate:policy isAuthenticated --api product` will create the policy at `./api/product/config/policies/isAuthenticated.js`.
+## strapi content-types:list
 
-- **strapi generate:policy &#60;name&#62; --plugin &#60;plugin&#62;**<br/>
-  Generates an empty policy called **&#60;name&#62;** in the `./plugins/<plugin>/config/policies` folder. This policy will be scoped and accessible only by the **&#60;plugin&#62;** routes.
+Display a list of all the existing [content-types](/developer-docs/latest/development/backend-customization/models.md).
 
-## strapi generate:plugin
-
-Create a new plugin skeleton.
-
-```bash
-strapi generate:plugin <name>
+```sh
+strapi content-types:list
 ```
 
-- **strapi generate:plugin &#60;name&#62;**<br/>
-  Generates an empty plugin called **&#60;name&#62;** in the `./plugins` folder.
+<!-- ? should we document this? only returns strapi::content-types.beforeSync and afterSync on a new project, and I don't want people to get confused as we officially "remove" hooks ? -->
+## strapi hooks:list
 
-  Example: `strapi generate:plugin user` will create the plugin at `./plugins/user`.
+Display a list of all the available hooks.
 
-Please refer to the [plugins development](/developer-docs/latest/development/plugins-development.md) section to know more.
-
-## strapi generate:template
-
-Create a template from the current strapi project
-
-```bash
-strapi generate:template <path>
+```sh
+strapi hooks:list
 ```
 
-- **strapi generate:template &#60;path&#62;**<br/>
-  Generates a Strapi template at `<path>`
+## strapi services:list
 
-  Example: `strapi generate:template ../strapi-template-name` will copy the required files and folders to a `template` directory inside `../strapi-template-name`
+Display a list of all the registered [services](/developer-docs/latest/development/backend-customization/services.md).
 
+```sh
+strapi services:list
+```
 
 ## strapi install
 

docs/developer-docs/latest/developer-resources/database-apis-reference/entity-service/components-dynamic-zones.md

@@ -7,11 +7,11 @@ description: …
 
 # Entity Service API: Components and dynamic zones
 
-The [Entity Service](/developer-docs/latest/developer-resources/database-apis-reference/entity-service-api.md) is the layer that handles [components](/developer-docs/latest/development/backend-customization/models.html#components-2) and [dynamic zones](/developer-docs/latest/development/backend-customization/models.html#dynamic-zones) logic. With the Entity Service API, components and dynamic zones can be [created](#creation) and [updated](#update) while creating or updating entries.
+The [Entity Service](/developer-docs/latest/developer-resources/database-apis-reference/entity-service-api.md) is the layer that handles [components](/developer-docs/latest/development/backend-customization/models.md#components-2) and [dynamic zones](/developer-docs/latest/development/backend-customization/models.md#dynamic-zones) logic. With the Entity Service API, components and dynamic zones can be [created](#creation) and [updated](#update) while creating or updating entries.
 
 ## Creation
 
-A [component](/developer-docs/latest/development/backend-customization/models.html#components-2) can be created while creating an entry with the Entity Service API:
+A [component](/developer-docs/latest/development/backend-customization/models.md#components-2) can be created while creating an entry with the Entity Service API:
 
 ```js
 strapi.entityService.create('api::article.article', {
@@ -23,7 +23,7 @@ strapi.entityService.create('api::article.article', {
 });
 ```
 
-A [dynamic zone](/developer-docs/latest/development/backend-customization/models.html#dynamic-zones) (i.e. a list of components) can be created while creating an entry with the Entity Service API:
+A [dynamic zone](/developer-docs/latest/development/backend-customization/models.md#dynamic-zones) (i.e. a list of components) can be created while creating an entry with the Entity Service API:
 
 ```js
 strapi.entityService.create('api::article.article', {
@@ -44,7 +44,7 @@ strapi.entityService.create('api::article.article', {
 
 ## Update
 
-A [component](/developer-docs/latest/development/backend-customization/models.html#components-2) can be updated while updating an entry with the Entity Service API. If a component `id` is specified, the component is updated, otherwise the old one is deleted and a new one is created:
+A [component](/developer-docs/latest/development/backend-customization/models.md#components-2) can be updated while updating an entry with the Entity Service API. If a component `id` is specified, the component is updated, otherwise the old one is deleted and a new one is created:
 
 ```js
 strapi.entityService.update('api::article.article', 1, {
@@ -57,7 +57,7 @@ strapi.entityService.update('api::article.article', 1, {
 });
 ```
 
-A [dynamic zone](/developer-docs/latest/development/backend-customization/models.html#dynamic-zones) (i.e. a list of components) can be updated while updating an entry with the Entity Service API. If a component `id` is specified, the component is updated, otherwise the old one is deleted and a new one is created:
+A [dynamic zone](/developer-docs/latest/development/backend-customization/models.md#dynamic-zones) (i.e. a list of components) can be updated while updating an entry with the Entity Service API. If a component `id` is specified, the component is updated, otherwise the old one is deleted and a new one is created:
 
 ```js
 strapi.entityService.update('api::article.article', 1, {