docs(VListItem): provide more detailed descriptions for item selection (

#19940)

Co-authored-by: Andrew Henry <[email protected]>

packages/api-generator/src/locale/en/VListItem.json

@@ -4,7 +4,7 @@
     "color": "Applies specified color to the control when in an **active** state or **input-value** is **true** - supports utility colors (for example `success` or `purple`) or css color (`#033` or `rgba(255, 0, 0, 0.5)`). Find a list of built-in classes on the [colors page](/styles/colors#material-colors),",
     "contained": "Changes the component style by changing how color is applied to the background.",
     "title": "Generates a `v-list-item-title` component with the supplied value. Note that this overrides the native [`title`](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/title) attribute, that must be set with `v-bind:title.attr` instead.",
-    "value": "The value used for selection.",
+    "value": "The value used for selection. Obtained from [`v-list`](/api/v-list)'s `v-model:selected` when the item is selected.",
     "lines": "The line declaration specifies the minimum height of the item and can also be controlled from v-list with the same prop.",
     "nav": "Reduces the width v-list-item takes up as well as adding a border radius.",
     "slim": "Reduces horizontal spacing for badges, icons, tooltips, and avatars to create a more compact visual representation."

packages/docs/src/pages/en/getting-started/upgrade-guide.md

@@ -191,7 +191,7 @@ app.use(vuetify)
 ### v-list
 
 - `two-line` and `three-line` props have been combined into a single `lines` prop with allowed values `'two'` or `'three'`.
-- `v-list-item-group` has been removed, just add `value` to list items to make them selectable and bind `v-model:selected` on v-list to get the selected value.
+- `v-list-item-group` has been removed, assign the item's key to the `value` prop of each `v-list-item` and bind `v-model:selected` on the `v-list` to get the selected value.
 - `v-list-item-icon` and `v-list-item-avatar` have been removed, use `v-list-item` with `icon` or `avatar` props, or put an icon or avatar in the append or prepend slot.
 - `v-list-item-content` has been removed, lists use CSS grid for layout now instead.
 - `v-list-group` can now be nested arbitrarily deep, `sub-group` prop should be removed.