sugguest using npm for package manager (#2533) (#2898)

Since we use pnpm to host our Strapi with MySQL, and we face an error on loading the mysql2 package

Co-authored-by: Soheil Nikroo <[email protected]>

Author: pwizla

docusaurus/docs/cms/deployment.md

@@ -35,6 +35,10 @@ If you already created a content structure with the Content-Type Builder and add
 Another possible workflow is to first create the content structure locally, push your project to a git-based repository, deploy the changes to production, and only then add content to the production instance.
 :::
 
+:::caution
+For self-hosted Kubernetes deployments, we recommend using **npm** rather than **pnpm**. `pnpm` aggressive hoisting of dependencies can break native modules, such as `mysql2`— that your application may rely on. `npm` flatter, more predictable `node_modules` layout helps ensure native packages load correctly.
+:::
+
 ## General guidelines
 
 ### Hardware and software requirements
@@ -231,4 +235,4 @@ The following external guide(s), not officially maintained by Strapi, might also
 
 :::strapi Multi-tenancy
 If you're looking for multi-tenancy options, the Strapi Blog has a <ExternalLink text="comprehensive guide" to="https://strapi.io/blog/multi-tenancy-in-strapi-a-comprehensive-guide" />.
-:::
+:::