Skip to content

XML: Convert docs to Markdown and use Args/Returns syntax - #5719

Open
Shaurya2k06 wants to merge 4 commits into
robotframework:masterfrom
Shaurya2k06:xml-library-markdown-docs
Open

XML: Convert docs to Markdown and use Args/Returns syntax#5719
Shaurya2k06 wants to merge 4 commits into
robotframework:masterfrom
Shaurya2k06:xml-library-markdown-docs

Conversation

@Shaurya2k06

@Shaurya2k06 Shaurya2k06 commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

What

  • Convert XML library and keyword documentation to Markdown.
  • Add structured Args/Returns for keywords.
  • Keep real data tables (xpath predicates, glob wildcards) as Markdown tables.
  • Align examples and formatting with maintainer style from merged library doc PRs.

Why

XML-only part of #5709.

Testing

  • py_compile on XML.py
  • Libdoc HTML generation succeeds (MARKDOWN); predicate/wildcard tables render as HTML tables

Take XML library documentation to Markdown and document
arguments and return values explicitly. Related to robotframework#5709.

Signed-off-by: shaurya2k06 <shaurya2k06@gmail.com>
Copilot AI lite review requested due to automatic review settings July 17, 2026 13:29

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot wasn't able to review any files in this pull request.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Signed-off-by: shaurya2k06 <shaurya2k06@gmail.com>
Copilot AI review requested due to automatic review settings July 27, 2026 06:12

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot wasn't able to review any files in this pull request.

Keep real data tables as Markdown tables, fix examples for highlighting,
and align Args/links with merged library doc style. Related to robotframework#5709.

Signed-off-by: shaurya2k06 <shaurya2k06@gmail.com>
Copilot AI review requested due to automatic review settings August 11, 2026 09:52

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot wasn't able to review any files in this pull request.

Unindented table rows prevented docstring dedent, and keyword examples
had invalid fence tags that libdoc could not highlight.

Signed-off-by: shaurya2k06 <shaurya2k06@gmail.com>
Copilot AI review requested due to automatic review settings August 13, 2026 08:46

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot wasn't able to review any files in this pull request.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants