arch(list): deprecate and add a flex-column list example

Deprecate the lv_list widget. A list is just a flex container with a column flow,
so it can be built directly from lv_obj with a LV_FLEX_FLOW_COLUMN layout.

Following the deprecation guidelines:
- @deprecated Doxygen tags and LV_DEPRECATED on lv_list_create
- LV_LOG_DEPRECATED runtime warning in lv_list_create
- migration-v10.mdx entry pointing to the replacement
- the new lv_example_flex_list shows how to build one from base widgets

Live call sites in the kept examples, demos and tests are wrapped with
LV_DEPRECATIONS_IGNORE_BEGIN/END so the -Wdeprecated -Werror build stays clean.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs/src/changelog/migration-v10.mdx

@@ -440,6 +440,14 @@ if you need finer control.
   [`lv_example_menu_navigation`](widgets/menu#building-a-menu-without-lv_menu)
   example for a starting point.
 
+### lv_list
+
+- The `lv_list` widget is deprecated. A list is just a flex container with a
+  column flow, so build one directly from `lv_obj` with a `LV_FLEX_FLOW_COLUMN`
+  layout instead. See the
+  [`lv_example_flex_list`](common-widget-features/layouts/flex#building-a-list)
+  example for a starting point.
+
 ---
 
 ## Drawing

docs/src/common-widget-features/layouts/flex.mdx

@@ -164,6 +164,12 @@ If the base direction of the container is set the
 The items on `ROW` layouts, and tracks of `COLUMN` layouts will be
 placed from right to left.
 
+## Building a list
+
+<LvglExample name="lv_example_flex_list" path="layouts/flex/lv_example_flex_list" />
+
+You can easily build a list using a column flex with 100% wide buttons and text.
+
 ## Forcing a New Track
 
 <LvglExample name="lv_example_flex_new_track" path="layouts/flex/lv_example_flex_new_track" />

docs/src/widgets/list.mdx

@@ -5,6 +5,14 @@ description: "A vertical container into which buttons and text rows can be added
 
 ## Overview
 
+<Callout type="warning" title="Deprecated">
+The `lv_list` widget is deprecated and kept only for backward compatibility. A
+list is just a flex container with a column flow, so build one directly from
+`lv_obj` with a `LV_FLEX_FLOW_COLUMN` layout instead. See the
+[`lv_example_flex_list`](/common-widget-features/layouts/flex#building-a-list)
+example for a starting point.
+</Callout>
+
 The List is a vertical container. You add full-width buttons and text rows
 to it; the layout takes care of stacking them.