Update syllabus docs for RF 7.5 concepts by bennyvw · Pull Request #100 · robotframework/robotframework-RFCP-syllabus

bennyvw · 2026-10-05T17:50:25Z

To be reviewed and discussed in our upcoming committee meeting.
I doubt if 'Robot Framework 7.5' should be mentioned literally.

Co-authored-by: bennyvw <32094302+bennyvw@users.noreply.github.com>

github-actions · 2026-10-05T17:51:39Z

🚀 Preview deployed to https://robotframework-RFCP-syllabus-pr-100.surge.sh/robotframework-RFCP-syllabus/

Copilot

Copilot review overview

🟡 Changes recommended

Some RF 7.5 guidance is inaccurate or inconsistent with the updated keyword interfaces.

Review effort: Balanced
Findings: 4

Open (4)

Clarify Metadata version requirement and name-value pair syntax · New
Avoid overstating external libraries' published documentation · New
Correct Should Be Equal optional argument count and screenshot · New
Distinguish deprecated ambiguous forms from valid compact syntax · New

What changed in this PR

Updates the syllabus for Robot Framework 7.5 concepts.

Changes:

Introduces test/task metadata and distinguishes it from tags.
Documents Libdoc formatting enhancements.
Covers deprecated tag-filter syntax.

File	Description
`04_tags.md`	Clarifies tag purposes and deprecated filters.
`05_keyword_interface.md`	Describes enhanced Libdoc output.
`01_suitefile.md`	Adds test/task metadata guidance.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

GerwinLaagland · 2026-10-14T21:05:02Z


 Each test case or task is structured using an indentation-based format. The first un-indented line specifies the name of the test|task, followed by indented lines containing **keyword calls** and their possible **arguments** and test|task-specific settings.
-These optional settings like `[Setup]`, `[Teardown]`, and `[Timeout]` can be applied to individual test cases or tasks to control their behavior or provide additional details.
+These optional settings like `[Setup]`, `[Teardown]`, `[Timeout]`, `[Tags]`, and `[Metadata]` can be applied to individual test cases or tasks to control their behavior or provide additional details.


Did we exclude tags here on purpose? It seems correct to add it. Also, if we do add 'metadata' we may need to add 'Test Metadata' in the glossary as well.

Suggestion here is to trial a 'exhaustive list' like in the user guide can be found:
https://robotframework.org/robotframework/latest/RobotFrameworkUserGuide.html#test-case-section

GerwinLaagland · 2026-10-14T21:17:59Z


 ![Should Be Equal Keyword Documentation](/img/Should_Be_Equal_Docs.png)

 This keyword has 2 "Mandatory Arguments" and 6 "Optional Arguments".


We should adjust this picture again. Should be Equal has gotten 8 optional arguments now.

Also SVG's need to be added:
https://github.com/robotframework/robotframework/tree/master/src/web/libdoc/icons

bennyvw · 2026-10-15T10:52:50Z

Use new svg's and add glossary item Test Metadata.

Clarify documentation expectations for keywords and user keywords.

Removed a sentence about documentation output formats.

github-actions · 2026-10-21T14:57:29Z

🚀 Preview deployed to https://robotframework-RFCP-syllabus-pr-100.surge.sh/robotframework-RFCP-syllabus/

Copilot

🔵 Needs a closer look

Version-specific wording and syllabus scope still require the requested committee review.

3 open issues

1 resolved since last review

Correct Should Be Equal optional argument count and screenshot

_{Review effort: Balanced}

github-actions · 2026-10-21T14:58:36Z

🚀 Preview deployed to https://robotframework-RFCP-syllabus-pr-100.surge.sh/robotframework-RFCP-syllabus/

Copilot

🟡 Changes recommended

The version-specific documentation and tag-deprecation notes remain despite explicit requests to remove them.

1 open issue

Distinguish deprecated ambiguous forms from valid compact syntax

2 resolved since last review

_{Review effort: Balanced}

Remove deprecated information about compact forms and Boolean operators.

github-actions · 2026-10-21T15:23:37Z

🚀 Preview deployed to https://robotframework-RFCP-syllabus-pr-100.surge.sh/robotframework-RFCP-syllabus/

Co-authored-by: bennyvw <32094302+bennyvw@users.noreply.github.com>

Copilot

🔵 Needs a closer look

The version-specific syllabus framing still needs the committee decision requested in the PR description.

No open issues 🎉

1 resolved since last review

Distinguish deprecated ambiguous forms from valid compact syntax

_{Review effort: Balanced}

Copilot

🔵 Needs a closer look

Syllabus scope and explicit RF 7.5 wording remain pending committee decisions.

No open issues 🎉

_{Review effort: Balanced}

github-actions · 2026-10-21T16:26:32Z

🚀 Preview deployed to https://robotframework-RFCP-syllabus-pr-100.surge.sh/robotframework-RFCP-syllabus/

Copilot

🟡 Changes recommended

Duplicate glossary entries create repeated rows, duplicate identifiers, and inconsistent definition lookup.

1 open issue

Remove duplicate Test Metadata glossary entry · New

_{Review effort: Balanced}

Removed 'Test Metadata' entry from glossary. Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

github-actions · 2026-10-21T16:32:23Z

🚀 Preview deployed to https://robotframework-RFCP-syllabus-pr-100.surge.sh/robotframework-RFCP-syllabus/

Copilot

🟡 Changes recommended

The explicit RF 7.5 sentence remains despite the developer’s request to remove it.

No open issues 🎉

1 resolved since last review

Remove duplicate Test Metadata glossary entry

_{Review effort: Balanced}

…://github.com/robotframework/robotframework-RFCP-syllabus into copilot/analyse-release-notes-impact-syllabus

github-actions · 2026-10-21T16:40:30Z

🚀 Preview deployed to https://robotframework-RFCP-syllabus-pr-100.surge.sh/robotframework-RFCP-syllabus/

Copilot

🔵 Needs a closer look

Final approval requires the planned committee decision on syllabus scope and version-specific wording.

No open issues 🎉

_{Review effort: Balanced}

github-actions · 2026-10-21T16:42:53Z

🚀 Preview deployed to https://robotframework-RFCP-syllabus-pr-100.surge.sh/robotframework-RFCP-syllabus/

Copilot

🟢 Approval recommended

The documentation changes are consistent, with no unresolved actionable findings.

No open issues 🎉

_{Review effort: Balanced}

Update syllabus docs for RF 7.5 concepts

f736854

Co-authored-by: bennyvw <32094302+bennyvw@users.noreply.github.com>

bennyvw requested review from a team and a balanced review from Copilot October 5, 2026 17:50

Copilot started reviewing on behalf of bennyvw October 5, 2026 17:50

View session

bennyvw deployed to preview October 5, 2026 17:51 — with GitHub Actions

View deployment

Copilot AI reviewed Oct 5, 2026

View reviewed changes

Comment thread website/docs/chapter-02/01_suitefile.md Resolved

Comment thread website/docs/chapter-02/05_keyword_interface.md Resolved

Comment thread website/docs/chapter-02/05_keyword_interface.md Resolved

Comment thread website/docs/chapter-04/04_tags.md Resolved

GerwinLaagland reviewed Oct 14, 2026

View reviewed changes

Comment thread website/docs/chapter-02/01_suitefile.md Resolved

GerwinLaagland reviewed Oct 14, 2026

View reviewed changes

Comment thread website/docs/chapter-02/05_keyword_interface.md Resolved

GerwinLaagland reviewed Oct 14, 2026

View reviewed changes

Comment thread website/docs/chapter-04/04_tags.md Resolved

GerwinLaagland reviewed Oct 15, 2026

View reviewed changes

Comment thread website/docs/chapter-02/05_keyword_interface.md Resolved

GerwinLaagland reviewed Oct 15, 2026

View reviewed changes

Comment thread website/docs/chapter-02/05_keyword_interface.md Resolved

Update documentation for keyword interface

d1d809d

Clarify documentation expectations for keywords and user keywords.

Copilot AI balanced review requested due to automatic review settings October 21, 2026 14:55

Copilot started reviewing on behalf of bennyvw October 21, 2026 14:56

View session

Update keyword interface documentation

6fd3bd0

Removed a sentence about documentation output formats.

Copilot AI reviewed Oct 21, 2026

View reviewed changes

Copilot AI balanced review requested due to automatic review settings October 21, 2026 14:57

Copilot started reviewing on behalf of bennyvw October 21, 2026 14:58

View session

bennyvw deployed to preview October 21, 2026 14:58 — with GitHub Actions

View deployment

Copilot AI reviewed Oct 21, 2026

View reviewed changes

Update tags section to remove deprecated content

9e0f961

Remove deprecated information about compact forms and Boolean operators.

bennyvw deployed to preview October 21, 2026 15:23 — with GitHub Actions

View deployment

Add Test Metadata glossary entry

5468cc0

Co-authored-by: bennyvw <32094302+bennyvw@users.noreply.github.com>

Copilot AI reviewed Oct 21, 2026

View reviewed changes

Copilot AI balanced review requested due to automatic review settings October 21, 2026 15:35

Copilot started reviewing on behalf of bennyvw October 21, 2026 15:36

View session

Copilot AI reviewed Oct 21, 2026

View reviewed changes

bennyvw added 2 commits October 21, 2026 18:17

Added Test Metadata to glossary

b78586a

Added links to glossary term Test Metadata

94e2b4b

Copilot AI balanced review requested due to automatic review settings October 21, 2026 16:24

bennyvw deployed to preview October 21, 2026 16:26 — with GitHub Actions

View deployment

Copilot AI reviewed Oct 21, 2026

View reviewed changes

Comment thread website/static/glossary/glossary.json Resolved

Copilot started reviewing on behalf of bennyvw October 21, 2026 16:30

View session

Delete 'Test Metadata' from glossary.json

e60bdbb

Removed 'Test Metadata' entry from glossary. Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot AI balanced review requested due to automatic review settings October 21, 2026 16:30

bennyvw deployed to preview October 21, 2026 16:32 — with GitHub Actions

View deployment

Copilot AI reviewed Oct 21, 2026

View reviewed changes

Copilot started reviewing on behalf of bennyvw October 21, 2026 16:33

View session

bennyvw added 2 commits October 21, 2026 18:38

New picture of Should be Equal

f5f8f1b

Merge branch 'copilot/analyse-release-notes-impact-syllabus' of https…

dc3084d

…://github.com/robotframework/robotframework-RFCP-syllabus into copilot/analyse-release-notes-impact-syllabus

Copilot AI balanced review requested due to automatic review settings October 21, 2026 16:38

Copilot started reviewing on behalf of bennyvw October 21, 2026 16:39

View session

bennyvw deployed to preview October 21, 2026 16:40 — with GitHub Actions

View deployment

Copilot AI reviewed Oct 21, 2026

View reviewed changes

Removed sentence that does not add value

84d73e3

Copilot AI balanced review requested due to automatic review settings October 21, 2026 16:41

Copilot started reviewing on behalf of bennyvw October 21, 2026 16:41

View session

bennyvw deployed to preview October 21, 2026 16:42 — with GitHub Actions

View deployment

Copilot AI reviewed Oct 21, 2026

View reviewed changes


		![Should Be Equal Keyword Documentation](/img/Should_Be_Equal_Docs.png)

		This keyword has 2 "Mandatory Arguments" and 6 "Optional Arguments".

Conversation

bennyvw commented Oct 5, 2026

Uh oh!

github-actions Bot commented Oct 5, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Copilot review overview

🟡 Changes recommended

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

GerwinLaagland Oct 14, 2026

Choose a reason for hiding this comment

Uh oh!

GerwinLaagland Oct 15, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

GerwinLaagland Oct 14, 2026

Choose a reason for hiding this comment

Uh oh!

GerwinLaagland Oct 15, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

bennyvw commented Oct 15, 2026

Uh oh!

github-actions Bot commented Oct 21, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🔵 Needs a closer look

Uh oh!

github-actions Bot commented Oct 21, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🟡 Changes recommended

Uh oh!

github-actions Bot commented Oct 21, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🔵 Needs a closer look

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🔵 Needs a closer look

Uh oh!

github-actions Bot commented Oct 21, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🟡 Changes recommended

Uh oh!

Uh oh!

github-actions Bot commented Oct 21, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🟡 Changes recommended

Uh oh!

github-actions Bot commented Oct 21, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🔵 Needs a closer look

Uh oh!

github-actions Bot commented Oct 21, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🟢 Approval recommended

Uh oh!