Skip to content

docs(recipe): read and assert on table rows with Locator.rows() #123

Closed

Description

@shossain786

Locator.rows() returns a table's data rows as header-keyed maps (added in #54) but has no recipe. Add one in docs-site/docs/recipes/: read rows, find a row by column value, assert a cell, and what happens with short rows and <th>-only group rows.

Acceptance: runnable snippet verified against a real table; sidebar entry; SEO description under 160 chars.

See CONTRIBUTING.md. Comment to claim it. Docs live in docs-site/docs/; follow an existing page as the template and run the docs site locally before opening the PR against master.

Activity

  1. May-Mei6 commented on Oct 14, 2026

    @May-Mei6
    Contributor

    Hi! My teammate @Lisr-iiil and I would be happy to work on this issue together if it’s still available.

    We plan to add a recipe in docs-site/docs/recipes/ covering reading rows, finding a row by column value, asserting a cell, and the behaviour with short rows and <th>-only group rows. We’ll verify the snippets against a real table, add the sidebar entry and SEO description, follow an existing recipe page as the template, and run the docs site locally before opening the PR against master.

    Would it be possible to assign this issue to both of us? Thank you!

  2. shossain786 commented on Oct 14, 2026

    @shossain786
    ContributorAuthor

    Hi @May-Mei6, thanks, and welcome. Working together on one PR is fine. I've assigned this to you; GitHub wouldn't let me add @Lisr-iiil as a second assignee because they haven't taken part in the repo yet. If they comment here once, I'll add them, or credit them with a Co-authored-by: trailer on your commits.

    Your plan covers the acceptance criteria. Two things to hold to: verify the snippets against a real table (not just by reading the Javadoc), and use an existing recipe page as the template for structure and the SEO description (under 160 chars).

  3. Lisr-iiil commented on Oct 14, 2026

    @Lisr-iiil
    Contributor

    Hi @shossain786, thanks for your reply!

    I'm happy to work on this issue with @May-Mei6. We'll make sure to test the snippets with a real table and follow an existing recipe page as suggested.

    Could you add me as a second assignee? Thanks!

  4. shossain786 commented on Oct 14, 2026

    @shossain786
    ContributorAuthor

    Thanks @Lisr-iiil, you're added as a second assignee. Over to you both. Open a draft PR early if you'd like a check on the page structure.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

documentationImprovements or additions to documentationgood first issueGood for newcomers

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions