Problem
src/pythonnative/virtual_rows.py is a public module with a full module docstring and Google-style class docs for RowSubtree and RowHostPool (it declares __all__ = ["RowSubtree", "RowHostPool"]), and it's covered by tests/test_native_lists.py. It's the piece that mounts a nested reconciler per row for natively virtualized lists (FlatList / SectionList on RecyclerView and UITableView).
There's no API reference page for it. mkdocs.yml lists a page for every other core module under API Reference (lines 106-135: reconciler, mutations, events, platform_metrics, native_views, and so on), but virtual_rows is missing, and nothing under docs/ mentions the module.
This is separate from #41, which covers the preview module.
Suggested fix
-
Add docs/api/virtual_rows.md following the pattern of docs/api/mutations.md: a one-paragraph intro, then
::: pythonnative.virtual_rows
options:
show_root_heading: false
show_root_toc_entry: false
members_order: source
filters: ["!^_"]
and a short "Next steps" list linking to reconciler.md, native_views.md, and ../guides/lists.md.
-
Add - Virtual rows: api/virtual_rows.md to the API Reference nav in mkdocs.yml, near Reconciler / Native views.
-
Optionally add a sentence with a link to the new page in docs/guides/lists.md where it describes per-row rendering.
Follow the documentation style guide for the prose.
Verification
- uv run --group docs mkdocs build --strict passes (strict mode fails on broken cross-references).
- uv run --group docs mkdocs serve shows the page with both classes rendered and the intra-doc links resolving.
Suggested commit message
docs(mkdocs): add virtual_rows API reference page
Reactions are currently unavailable
Problem
src/pythonnative/virtual_rows.py is a public module with a full module docstring and Google-style class docs for RowSubtree and RowHostPool (it declares __all__ = ["RowSubtree", "RowHostPool"]), and it's covered by tests/test_native_lists.py. It's the piece that mounts a nested reconciler per row for natively virtualized lists (FlatList / SectionList on RecyclerView and UITableView).
There's no API reference page for it. mkdocs.yml lists a page for every other core module under API Reference (lines 106-135: reconciler, mutations, events, platform_metrics, native_views, and so on), but virtual_rows is missing, and nothing under docs/ mentions the module.
This is separate from #41, which covers the preview module.
Suggested fix
Add docs/api/virtual_rows.md following the pattern of docs/api/mutations.md: a one-paragraph intro, then
::: pythonnative.virtual_rows options: show_root_heading: false show_root_toc_entry: false members_order: source filters: ["!^_"]and a short "Next steps" list linking to reconciler.md, native_views.md, and ../guides/lists.md.
Add - Virtual rows: api/virtual_rows.md to the API Reference nav in mkdocs.yml, near Reconciler / Native views.
Optionally add a sentence with a link to the new page in docs/guides/lists.md where it describes per-row rendering.
Follow the documentation style guide for the prose.
Verification
Suggested commit message