docs: improvement docs

Author: kazupon

docs/guide/essentials/pluralization.md

@@ -35,7 +35,6 @@ Vue I18n offers some ways to support pluralization. Here we’ll use the `$t`.
 Some ways to support pluralization are:
 
 - injected global `$t`
-- `v-t` custom directive
 - built-in Translation component (`i18n-t`)
 - exported `t` from `useI18n` (for Composition API mode)
 :::

docs/guide/essentials/started.md

@@ -103,8 +103,9 @@ If you need a refresher about the two styles, see [Vue - API Styles](https://vue
 
 Vue I18n works with both Vue composition API and Options API. Vue I18n has two APIs style like Vue, Composition API and Legacy API for options API using.
 
-:::tip NOTE
+:::danger IMPORTANT
 In Vue I18n v9 and later, the API offered by Vue I18n v8.x is called **Legacy API** mode.
+Legacy API is deprecated Vue I18n v11, and drop Vue I18n v12. We recommend use Composition API mode.
 :::
 
 The following sections will be explained using the Legacy API.

docs/guide/installation.md

@@ -46,25 +46,25 @@ app.mount('#app')
 
 ## Direct Download
 
-<https://unpkg.com/vue-i18n@10>
+<https://unpkg.com/vue-i18n@11>
 
 [unpkg.com](https://unpkg.com) provides a npm-based CDN links. The above link will always point to the latest release on npm.
 
 ### Global import
 
 ```html
 <script src="https://unpkg.com/vue@3"></script>
-<script src="https://unpkg.com/vue-i18n@10"></script>
+<script src="https://unpkg.com/vue-i18n@11"></script>
 ```
 
-You can also use a specific version/tag via URLs like <https://unpkg.com/vue-i18n@10.0.0/dist/vue-i18n.global.js>
+You can also use a specific version/tag via URLs like <https://unpkg.com/vue-i18n@11.0.0/dist/vue-i18n.global.js>
 
 ### ES Modules import
 
 ```html
 <script type="module" src="https://unpkg.com/vue@3/dist/vue.esm-browser.js">
-<script type="module" src="https://unpkg.com/vue-i18n@9/dist/vue-i18n.esm-browser.js">
+<script type="module" src="https://unpkg.com/vue-i18n@11/dist/vue-i18n.esm-browser.js">
 ```
 
-You can also use a specific version/tag via URLs like <https://unpkg.com/vue-i18n@10.0.0/dist/vue-i18n.esm-browser.js>
+You can also use a specific version/tag via URLs like <https://unpkg.com/vue-i18n@11.0.0/dist/vue-i18n.esm-browser.js>
 

docs/guide/migration/breaking11.md

@@ -28,6 +28,14 @@ In addition, Vue 3 Virtual DOM optimization has been introduced, and the optimiz
 
 For compatibility, `v-t` mode still works in v11, but will be removed entirely in v12, so `v-t` will not work after that version.
 
+### for migration
+
+You can use `eslint-plugin-vue-i18n`.
+
+`eslint-plugin-vue-i18n` has `@intlify/vue-i18n/no-deprecated-v-t` rule. https://eslint-plugin-vue-i18n.intlify.dev/rules/no-deprecated-v-t.html
+
+You must have migrated with eslint before upgrading to vue-i18n v11
+
 ## Drop `tc` and `$tc` for Legacy API mode
 
 **Reason**: These APIs had already deprecated in warning about being dropped in v11. docs says, https://vue-i18n.intlify.dev/guide/migration/breaking10.html#deprecate-tc-and-tc-for-legacy-api-mode

packages/vue-i18n-core/src/directive.ts

@@ -83,6 +83,8 @@ function getComposer(
  * <p v-t="{ path: greeting, args: { name: fullName } }"></p>
  * ```
  *
+ * @deprecated will be removed at vue-i18n v12
+ *
  * @VueI18nDirective
  */
 export type TranslationDirective<T = HTMLElement> = ObjectDirective<T>