Changes to typescript generation CLI (#1736)

* remove --file and add warning for --out-dir

* update docs to match new usage

* change schema file to types folder

* Update docusaurus/docs/dev-docs/cli.md

---------

Co-authored-by: Pierre Wizla <[email protected]>

Author: innerdvations

docusaurus/docs/dev-docs/cli.md

@@ -356,14 +356,17 @@ Generate [TypeScript](/dev-docs/typescript.md) typings for the project schemas.
 strapi ts:generate-types
 ```
 
-* **strapi ts:generate-types --verbose**<br/>
-  Generate typings with the verbose mode enabled, displaying a detailed table of the generated schemas.
-* **strapi ts:generate-types --silent** or **strapi ts:generate-types -s**<br/>
-  Generate typings with the silent mode enabled, completely removing all the logs in the terminal.
-* **strapi ts:generate-types --out-dir &#60;path&#62;** or **strapi ts:generate-types -o &#60;path&#62;**<br/>
+- **strapi ts:generate-types --debug**<br />
+  [DEPRECATED] **strapi ts:generate-types --verbose**<br/>
+  Generate typings with the debug mode enabled, displaying a detailed table of the generated schemas.
+- **strapi ts:generate-types --silent** or **strapi ts:generate-types -s**<br/>
+  Generate typings with the silent mode enabled, completely removing all the logs in the terminal. Cannot be combined with `verbose` or `debug`
+- **strapi ts:generate-types --out-dir &#60;path&#62;** or **strapi ts:generate-types -o &#60;path&#62;**<br/>
   Generate typings specifying the output directory in which the file will be created.
-* **strapi ts:generate-types --file &#60;filename&#62;** or **strapi ts:generate-types -f &#60;filename&#62;**<br/>
-  Generate typings specifying the name of the file to contain the types declarations.
+
+:::caution
+Strapi requires the project types to be generated in the `types` directory for them to work. The `--out-dir` option should not be used for most cases. However, it can be useful for cases such as generating a second copy to compare the difference between your existing and updated types after changing your content structure.
+:::
 
 ## strapi routes:list
 

docusaurus/docs/dev-docs/typescript.md

@@ -65,23 +65,23 @@ To experience TypeScript-based autocomplete while developing Strapi applications
 
 ## Generate typings for project schemas
 
-To generate typings for your project schemas use the [`ts:generate-types` CLI command](/dev-docs/cli#strapi-ts-generate-types). The `ts:generate-types` command creates the file `schemas.d.ts`, at the project root, which stores the schema typings. The optional `--verbose` flag returns a detailed table of the generated schemas.
+To generate typings for your project schemas use the [`ts:generate-types` CLI command](/dev-docs/cli#strapi-ts-generate-types). The `ts:generate-types` command creates the a folder `types`, at the project root, which stores the typings for your project. The optional `--debug` flag returns a detailed table of the generated schemas.
 
 To use `ts:generate-types`run the following code in a terminal at the project root:
 
 <Tabs groupId="yarn-npm">
 <TabItem value="npm">
 
 ```sh
-npm run strapi ts:generate-types --verbose #optional flag
+npm run strapi ts:generate-types --debug #optional flag to display additional logging
 ```
 
 </TabItem>
 
 <TabItem value="yarn">
 
 ```sh
-yarn strapi ts:generate-types --verbose #optional flag
+yarn strapi ts:generate-types --debug #optional flag to display additional logging
 ```
 
 </TabItem>