Document about alternative JS assets installation with npm packages

Author: Kocal

assets/README.md

@@ -1,10 +1,18 @@
 # @symfony/ux-vue
 
-Integration of Vue.js in Symfony.
+JavaScript assets of the [symfony/ux-vue](https://packagist.org/packages/symfony/ux-vue) PHP package.
 
-**ℹ️ Direct installation of this package is for advanced users only.** We strongly recommend installing it through the PHP package [symfony/ux-vue](https://packagist.org/packages/symfony/ux-vue) in a Symfony application with Flex enabled.
+## Installation
 
-If you still want to install this package directly, **make sure its version exactly matches [symfony/ux-vue](https://packagist.org/packages/symfony/ux-vue) PHP package version.**
+This npm package is **reserved for advanced users** who want to decouple their JavaScript dependencies from their PHP dependencies (e.g., when building Docker images, running JavaScript-only pipelines, etc.).
+
+We **strongly recommend not installing this package directly**, but instead  install the PHP package [symfony/ux-vue](https://packagist.org/packages/symfony/ux-vue) in your Symfony application with [Flex](https://github.com/symfony/flex) enabled.
+
+If you still want to install this package directly, please make sure its version exactly matches [symfony/ux-vue](https://packagist.org/packages/symfony/ux-vue) PHP package version:
+```shell
+composer require symfony/ux-vue:2.23.0
+npm add @symfony/ux-vue@2.23.0
+```
 
 ## Resources
 

doc/index.rst

@@ -35,6 +35,10 @@ Next, install a package to help Vue:
     $ npm install -D vue-loader --force
     $ npm run watch
 
+.. note::
+
+    For more complex installation scenarios, you can install the JavaScript assets through the `@symfony/ux-vue npm package`_
+
 That's it! Any files inside ``assets/vue/controllers/`` can now be rendered as
 Vue components.
 
@@ -182,3 +186,4 @@ https://symfony.com/doc/current/contributing/code/bc.html
 .. _`Vue.js`: https://vuejs.org/
 .. _`the Symfony UX initiative`: https://ux.symfony.com/
 .. _ `the related section of the documentation`: https://symfony.com/doc/current/frontend/encore/vuejs.html
+.. _`@symfony/ux-vue npm package`: https://www.npmjs.com/package/@symfony/ux-vue