removed ListProvider docs and updated ListRow mdx file

Author: LinKCoding

packages/styleguide/src/lib/Organisms/Lists & Tables/List/About.mdx

@@ -8,7 +8,6 @@ import {
 
 import { parameters as listParameters } from './List.mdx';
 import { parameters as listColParameters } from './ListCol/ListCol.mdx';
-import { parameters as listProviderParameters } from './ListProvider/ListProvider.mdx';
 import { parameters as listRowParameters } from './ListRow/ListRow.mdx';
 import { parameters as tableHeaderParameters } from './TableHeader/TableHeader.mdx';
 
@@ -23,12 +22,11 @@ export const parameters = {
 
 <AboutHeader {...parameters} />
 
-Use `List` as the root container, with `ListRow` and `ListCol` defining each row and column. For table layouts (`as="table"`), add `TableHeader` for a header row. Context from `ListProvider` (provided by `List`) drives spacing, variant, and responsive behavior—see `ListProvider` for hooks and advanced usage.
+Use `List` as the root container, with `ListRow` and `ListCol` defining each row and column. For table layouts (`as="table"`), add `TableHeader` for a header row. `List` wraps its subtree in `ListProvider` so rows, columns, and the header share spacing, variant, and responsive layout context.
 
 <TableOfContents
   links={addParentPath(parameters.id, [
     listParameters,
-    listProviderParameters,
     listRowParameters,
     listColParameters,
     tableHeaderParameters,

packages/styleguide/src/lib/Organisms/Lists & Tables/List/List.mdx

@@ -32,8 +32,7 @@ export const parameters = {
 
 ### Components
 
-- `List`: Root list or table wrapper; sets spacing, variant, `as` (`ul` | `ol` | `table`), scrollable layout, and container-query behavior.
-- `ListProvider`: Supplied by `List`; use <LinkTo id="Organisms/Lists & Tables/List/ListProvider">ListProvider</LinkTo> for `useListContext` / `useList` when building custom list internals.
+- `List`: Root list or table wrapper; sets spacing, variant, `as` (`ul` | `ol` | `table`), scrollable layout, and container-query behavior. It wraps children in `ListProvider` so `ListRow`, `ListCol`, and `TableHeader` share layout context (`useListContext` for advanced list internals; prefer `List` props over the internal `useList` hook).
 - `ListRow`: One logical row; supports expandable content. See <LinkTo id="Organisms/Lists & Tables/List/ListRow">ListRow</LinkTo>.
 - `ListCol`: Column cell with sizing, `type`, and justification. See <LinkTo id="Organisms/Lists & Tables/List/ListCol">ListCol</LinkTo>.
 - `TableHeader`: Sticky header row for `as="table"`. See <LinkTo id="Organisms/Lists & Tables/List/TableHeader">TableHeader</LinkTo>.

packages/styleguide/src/lib/Organisms/Lists & Tables/List/ListProvider/ListProvider.mdx

@@ -22,35 +22,35 @@ export const parameters = {
 
 ## Usage
 
-`ListRow` renders one logical row. It reads spacing, variant, and layout from `List` via `ListProvider`. Compose rows with <LinkTo id="Organisms/Lists & Tables/List/ListCol">ListCol</LinkTo> children.
+`ListRow` renders a single row. It receives spacing, variant, and layout from `List`. Compose each row with <LinkTo id="Organisms/Lists & Tables/List/ListCol">ListCol</LinkTo> children.
 
-For table layouts (`List` with `as="table"`), body rows still use `ListRow`. Header labels belong in <LinkTo id="Organisms/Lists & Tables/List/TableHeader">TableHeader</LinkTo> with `ListCol` cells—see <LinkTo id="Organisms/Lists & Tables/List/ListCol">ListCol</LinkTo> (Header columns).
+For table layouts (`List` with `as="table"`), the rows still use `ListRow`. However, the header row should use <LinkTo id="Organisms/Lists & Tables/List/TableHeader">TableHeader</LinkTo>. 
 
 ### Plain variant styling
 
-When the parent `List` uses `variant="plain"`, you can still style individual rows (for example with Emotion `styled`) to emphasize or group items.
+As noted in <LinkTo id="Organisms/Lists & Tables/List/List">List</LinkTo>, when the parent `List` uses `variant="plain"`, style individual `ListRow` components using Emotion's `styled` function to emphasize or group items.
 
 <Canvas of={ListRowStories.PlainStyled} />
 
 ## Expandable rows
 
-You can define collapsible content by passing an `expanded` prop and a `renderExpanded` callback that returns the expanded region.
+Define collapsible content with an `expanded` prop and a `renderExpanded` callback that returns the expanded region.
 
 ### Expand on button click
 
-The `ListRow` can include `ExpandControl` in a `ListCol` with `type="control"` to toggle expansion. `ExpandControl` rotates its icon based on `expanded`.
+Include `ExpandControl` in a `ListCol` with `type="control"` to toggle expansion. `ExpandControl` rotates its icon based on `expanded`.
 
 <Canvas of={ListRowStories.ExpandableButtonGuide} />
 
 ### Expand on row click
 
-An entire row can toggle expansion via `onClick` on `ListRow` (non-table lists).
+When `List` does not use `as="table"`, use `onClick` on `ListRow` so the whole row toggles expansion.
 
 <Canvas of={ListRowStories.ExpandedRowGuide} />
 
 ## Playground
 
-For full `List` props and variants, see <LinkTo id="Organisms/Lists & Tables/List/List">List</LinkTo>.
+Adjust `ListRow` on the expandable example. For `List` props and variants, see <LinkTo id="Organisms/Lists & Tables/List/List">List</LinkTo>.
 
 <Canvas sourceState="shown" of={ListRowStories.ExpandableButtonGuide} />