Documentation: Elaborates on Table related classes.

[jamie-lemon]

No description provided.

[Copilot]

Pull Request Overview

This PR updates the documentation for table-related classes in the project, providing clearer Sphinx directives and more detailed attribute and method descriptions.

• Improved Sphinx markup for Page-level methods.
• Enhanced attribute and method documentation for Table, TableHeader, and TableRow classes.
• Added clarifying notes and type annotations for better readability and consistency.

Comments suppressed due to low confidence (2)

docs/page.rst:2386

• The type annotation for the 'page' attribute in the Table class is set as a string. If this attribute actually represents a Page object, consider updating it to :class:Page to match its intended usage.

:type: `string`

docs/page.rst:2440

• The documentation for the to_markdown() method suggests that table data is extracted into a list, yet the return type is marked as a string. Please clarify whether this method returns a markdown string or a list, and update the description and :type: annotation accordingly.

Extracts table data into a list.

[JorjMcKie]

There are several corrections ...