fixed glossary feedback

Co-authored-by: Copilot <copilot@github.com>

Author: Snooz82

website/docs/chapter-02/01_suitefile.md

@@ -128,7 +128,7 @@ It allows you to import keywords from external libraries (`Library`) or resource
 
 In this section, the suite name, that is normally derived from the file name, can be redefined with the `Name` setting and its documentation can be defined with the `Documentation` setting.
 
-Additional metadata can be defined by multiple `Metadata` entries, which can contain key-value pairs that can be used to store additional information about the suite, like the author, the version, or related requirements of the suite.
+Additional suite metadata can be defined by multiple `Metadata` entries, which can contain key-value pairs that can be used to store additional information about the suite, like the author, the version, or related requirements of the suite.
 
 This section can also define keywords called for execution flow control, such as `Suite Setup` and `Suite Teardown`, which are executed before and after the suite's tests run. See [4.1 Setups (Suite, Test|Task, Keyword)](chapter-04/01_setups.md) and
 [4.2 Teardowns (Suite, Test|Task, Keyword)](chapter-04/02_teardowns.md) for more information.

website/docs/chapter-04/03_init_files.md

@@ -68,7 +68,7 @@ The following sections are allowed in initialization files:
 - **`*** Settings ***` Section (required)**:
   - `Name`: Set a custom name for the suite directory.
   - `Documentation`: Provide documentation for the suite.
-  - `Metadata`: Add metadata to the suite.
+  - `Metadata`: Add suite metadata.
   - `Suite Setup`: Define a keyword to be executed before any tests|tasks or child suites.
   - `Suite Teardown`: Define a keyword to be executed after all tests|tasks and child suites have completed.
   - `Test Setup`|`Task Setup`: Set a default setup keyword for all tests|tasks in the suite (can be overridden in lower-level suites or tests|tasks).

website/docs/chapter-04/04_tags.md

@@ -12,7 +12,7 @@ Recall the purpose of Test|Task Tags in Robot Framework
 ::::
 
 In Robot Framework, **tags** offer a simple yet powerful mechanism for classifying and controlling the execution of tests|tasks.
-Tags are free-form text labels that can be assigned to tests|tasks to provide metadata, enable flexible test selection, and organize test results.
+Tags are free-form text labels that can be assigned to tests|tasks to provide meta information, enable flexible test selection, and organize test results.
 
 Tags are also used to create a statistical summary of the test|task results in the execution protocols.
 

website/static/glossary/glossary.json

@@ -45,7 +45,7 @@
 		"term": "Behavior-Driven Specification",
 		"aliases": [],
 		"abbreviation": "",
-		"definition": "Declarative Robot Framework style where tests|tasks describe system behavior from the user perspective using natural-language-like steps with embedded arguments and optional Given/When/Then/And/But prefixes."
+		"definition": "Declarative Robot Framework style in which tests or tasks describe system behavior from the user's perspective using natural-language-like steps with embedded arguments and optional Given/When/Then/And/But prefixes."
 	},
 	{
 		"term": "Built-In Variables",
@@ -63,7 +63,7 @@
 		"term": "Composite Element",
 		"aliases": [],
 		"abbreviation": "",
-		"definition": "Execution element composed of child elements (for example suites with tests|tasks, tests|tasks with keywords, or user keywords with child steps) whose status is derived from its children."
+		"definition": "Execution element composed of child elements (for example suites with tests or tasks, tests or tasks with keywords, or user keywords with child steps) whose status is derived from its children."
 	},
 	{
 		"term": "Control Structure",
@@ -75,14 +75,20 @@
 		"term": "Data-Driven Specification",
 		"aliases": [],
 		"abbreviation": "",
-		"definition": "Specification style where the same logic or test flow is executed multiple times with varying input or expected output data, often implemented with test|task templates."
+		"definition": "Specification style where the same logic or test flow is executed multiple times with varying input or expected output data, often implemented with test or task templates."
 	},
 	{
 		"term": "Definition Layer",
 		"aliases": [],
 		"abbreviation": "",
 		"definition": "Layer in the Generic Test Automation Architecture (gTAA) containing test data such as suites, tests, tasks, resource files, keywords, and variables written in Robot Framework syntax."
 	},
+	{
+		"term": "Dictionary Variable",
+		"aliases": [],
+		"abbreviation": "&{}",
+		"definition": "Robot Framework variable of dictionary type created with the `&{}` syntax that holds key-value pairs and can be accessed by keys."
+	},
 	{
 		"term": "Embedded Argument",
 		"aliases": [],
@@ -99,7 +105,7 @@
 		"term": "Execution Artifacts",
 		"aliases": [],
 		"abbreviation": "",
-		"definition": "Files produced by Robot Framework execution—such as `output.xml`, `log.html`, and `report.html`—that document what was executed and with which results."
+		"definition": "Files generated by a Robot Framework execution (such as `output.xml`, `log.html`, and `report.html`) that document the execution process and its results."
 	},
 	{
 		"term": "Execution Layer",
@@ -128,13 +134,13 @@
 	{
 		"term": "Free Named Argument",
 		"aliases": ["**kwargs"],
-		"abbreviation": "kwargs",
+		"abbreviation": "",
 		"definition": "Catch-all named argument kind in a keyword specification, marked with **, that gathers all named values not explicitly defined elsewhere into a dictionary."
 	},
 	{
 		"term": "Generic Test Automation Architecture",
 		"aliases": ["gTAA"],
-		"abbreviation": "gTAA",
+		"abbreviation": "",
 		"definition": "Layered reference architecture for test automation that separates definition, execution, and adaptation layers and describes Robot Framework’s role in an automation solution."
 	},
 	{
@@ -150,14 +156,14 @@
 		"definition": "Variable with global scope that can be accessed from all suites and keywords in a Robot Framework execution."
 	},
 	{
-		"term": "Higher-Level Suite (Suite Directory)",
-		"aliases": [],
-		"abbreviation": "",
-		"definition": "Directory treated as a suite because it directly or indirectly contains at least one suite file, grouping lower-level suites into a suite tree."
+		"term": "IF statement",
+		"aliases": ["IF/ELSE"],
+		"abbreviation": "IF",
+		"definition": "Control structure in Robot Framework used to execute one block of statements when a condition is true and optionally alternative blocks with `ELSE IF` or `ELSE` when it is not."
 	},
 	{
-		"term": "Initialization File (__init__.robot)",
-		"aliases": [],
+		"term": "Initialization File",
+		"aliases": ["__init__.robot", "Suite Initialization File"],
 		"abbreviation": "",
 		"definition": "Suite file located in a directory that configures that directory as a suite and defines suite-level settings, variables, setups, and teardowns for contained suites."
 	},
@@ -173,12 +179,6 @@
 		"abbreviation": "",
 		"definition": "Compact single-line IF statement (`IF  <condition>  <keyword>  [args]`) used to execute one keyword conditionally without an END."
 	},
-	{
-		"term": "K-Level (Knowledge Level)",
-		"aliases": [],
-		"abbreviation": "",
-		"definition": "Categorization of learning objectives based on Bloom’s Taxonomy: K1 (Remember), K2 (Understand), and K3 (Apply), indicating expected depth of knowledge."
-	},
 	{
 		"term": "Keyword",
 		"aliases": [],
@@ -189,25 +189,31 @@
 		"term": "Keyword Interface",
 		"aliases": [],
 		"abbreviation": "",
-		"definition": "Documented information of a keyword—including name, arguments with kinds and types, return values, documentation, and examples—as exposed by HTML documentation or IDEs."
+		"definition": "Documented information about a keyword, including its name, arguments with kinds and types, return values, documentation, and examples, as exposed by HTML documentation or IDEs."
 	},
 	{
 		"term": "Keyword-Driven Specification",
 		"aliases": [],
 		"abbreviation": "",
-		"definition": "Imperative Robot Framework style where tests|tasks are written as sequences of keyword calls with arguments, focusing on executed actions and their order."
+		"definition": "Imperative Robot Framework style where tests or tasks are written as sequences of keyword calls with arguments, focusing on executed actions and their order."
 	},
 	{
 		"term": "Keyword Library",
 		"aliases": ["Library"],
 		"abbreviation": "",
 		"definition": "Collection of library keywords implemented typically in Python (or other languages) that Robot Framework imports to interact with external systems, perform computations, or provide utility functions."
 	},
+	{
+		"term": "Knowledge Level",
+		"aliases": [],
+		"abbreviation": "K-Level",
+		"definition": "Categorization of learning objectives based on Bloom’s Taxonomy: K1 (Remember), K2 (Understand), and K3 (Apply), indicating expected depth of knowledge."
+	},
 	{
 		"term": "List Variable",
 		"aliases": [],
-		"abbreviation": "",
-		"definition": "Robot Framework variable of list type accessed with the `@{}` syntax that holds an ordered collection of values and can be unpacked when passed to keywords."
+		"abbreviation": "@{}",
+		"definition": "Robot Framework variable of list type created with the `@{}` syntax that holds an ordered collection of values and can be unpacked when passed to keywords."
 	},
 	{
 		"term": "Local Variable",
@@ -216,8 +222,8 @@
 		"definition": "Variable whose scope is limited to a single keyword, test, or task execution and is not visible outside that body."
 	},
 	{
-		"term": "Log File (log.html)",
-		"aliases": [],
+		"term": "Log File",
+		"aliases": ["log.html"],
 		"abbreviation": "",
 		"definition": "Detailed HTML execution log (log.html) generated by Robot Framework that shows keyword-level execution steps, arguments, messages, and statuses."
 	},
@@ -228,10 +234,10 @@
 		"definition": "Argument kind in a keyword specification without a default value that must be provided in calls and that precedes optional arguments."
 	},
 	{
-		"term": "Metadata (Suite Metadata)",
+		"term": "Suite Metadata",
 		"aliases": [],
 		"abbreviation": "",
-		"definition": "Key–value information defined with the Metadata setting in a suite to document attributes such as author, version, or related requirements."
+		"definition": "Key–value information defined with the `Metadata` setting in a suite to document attributes such as author, version, or related requirements."
 	},
 	{
 		"term": "Named-Only Argument",
@@ -246,10 +252,10 @@
 		"definition": "Argument value provided in a keyword call using an explicit name=value pair."
 	},
 	{
-		"term": "Output File (output.xml)",
-		"aliases": [],
+		"term": "Output File",
+		"aliases": ["output.xml"],
 		"abbreviation": "",
-		"definition": "Machine-readable execution result file (output.xml) produced by Robot Framework that contains the full execution tree, messages, and statistics in XML format."
+		"definition": "Primary machine-readable execution result file (e.g.`output.xml`) produced by Robot Framework that stores the full execution tree, messages, and statistics and serves as the source for generating log and report files."
 	},
 	{
 		"term": "Optional Argument",
@@ -276,10 +282,10 @@
 		"definition": "Argument kind in a keyword specification that can be set either by position or by name (but not both for the same value) and that may be mandatory or optional."
 	},
 	{
-		"term": "Report File (report.html)",
-		"aliases": [],
+		"term": "Report File",
+		"aliases": ["report.html"],
 		"abbreviation": "",
-		"definition": "High-level HTML summary (report.html) of a Robot Framework execution that focuses on statistics and overall pass/fail status of suites and tests|tasks."
+		"definition": "High-level HTML summary (`report.html`) of a Robot Framework execution that focuses on statistics and the overall pass/fail status of suites and tests or tasks."
 	},
 	{
 		"term": "Resource File",
@@ -288,8 +294,8 @@
 		"definition": "File (commonly with extension .resource or .robot) that contains user keywords and variables and is imported by suites to share and reuse these artifacts."
 	},
 	{
-		"term": "Return Statement (RETURN)",
-		"aliases": [],
+		"term": "RETURN Statement",
+		"aliases": ["RETURN"],
 		"abbreviation": "",
 		"definition": "Statement used in user keywords to return one or more values that can be assigned to variables in the calling context."
 	},
@@ -302,7 +308,7 @@
 	{
 		"term": "Robotic Process Automation",
 		"aliases": ["RPA"],
-		"abbreviation": "RPA",
+		"abbreviation": "",
 		"definition": "Automation of business processes or tasks normally performed by humans, often across multiple systems, without necessarily focusing on testing."
 	},
 	{
@@ -314,7 +320,7 @@
 	{
 		"term": "Robot Framework® Certified Professional",
 		"aliases": ["RFCP"],
-		"abbreviation": "RFCP",
+		"abbreviation": "",
 		"definition": "Foundational certification level for Robot Framework that validates understanding of core concepts, syntax, and basic control structures."
 	},
 	{
@@ -324,10 +330,10 @@
 		"definition": "Top-level suite in a Robot Framework execution determined by the initial directory or file path passed to the `robot` command."
 	},
 	{
-		"term": "Scalar Access Syntax (${})",
+		"term": "Scalar Access Syntax",
 		"aliases": [],
-		"abbreviation": "",
-		"definition": "Standard variable access form in Robot Framework used to read values regardless of whether the underlying variable was defined as scalar, list-like, or dictionary-like."
+		"abbreviation": "${}",
+		"definition": "Standard variable access form `${}` in Robot Framework used to read values regardless of whether the underlying variable was defined as scalar, list-like, or dictionary-like."
 	},
 	{
 		"term": "Scalar Variable",
@@ -342,17 +348,23 @@
 		"definition": "Execution status indicating that an element (such as a test or task) was intentionally not executed, for example due to selection options or an explicit skip."
 	},
 	{
-		"term": "Standard Library (Robot Framework)",
+		"term": "Standard Library",
 		"aliases": [],
 		"abbreviation": "",
 		"definition": "Library shipped with Robot Framework itself providing generic functionality such as operating system interaction, string manipulation, or process handling."
 	},
 	{
-		"term": "Suite (Test Suite / Task Suite)",
-		"aliases": [],
+		"term": "Suite",
+		"aliases": ["Test Suite", "Task Suite"],
 		"abbreviation": "",
 		"definition": "Collection of tests or tasks (optionally with local keywords and variables) defined in a .robot file or directory that is executed as a unit by Robot Framework."
 	},
+	{
+		"term": "Suite Directory",
+		"aliases": ["Higher-Level Suite"],
+		"abbreviation": "",
+		"definition": "Directory treated as a suite because it directly or indirectly contains at least one suite file, grouping lower-level suites into a suite tree."
+	},
 	{
 		"term": "Suite File",
 		"aliases": [],
@@ -363,19 +375,19 @@
 		"term": "Suite Setup",
 		"aliases": [],
 		"abbreviation": "",
-		"definition": "Keyword executed once before any tests|tasks in a suite are run, typically used to prepare common preconditions."
+		"definition": "Keyword executed once before any tests or tasks in a suite are run, typically used to prepare common preconditions."
 	},
 	{
 		"term": "Suite Teardown",
 		"aliases": [],
 		"abbreviation": "",
-		"definition": "Keyword executed once after all tests|tasks in a suite have run, typically used to clean up shared resources."
+		"definition": "Keyword executed once after all tests or tasks in a suite have run, typically used to clean up shared resources."
 	},
 	{
 		"term": "Suite Variable",
 		"aliases": [],
 		"abbreviation": "",
-		"definition": "Variable whose scope covers all tests|tasks and keywords within a specific suite but is not visible outside that suite."
+		"definition": "Variable whose scope covers all tests or tasks and keywords within a specific suite but is not visible outside that suite."
 	},
 	{
 		"term": "Synthetic Monitoring",
@@ -385,32 +397,32 @@
 	},
 	{
 		"term": "Task",
-		"aliases": ["Test Case"],
+		"aliases": [],
 		"abbreviation": "",
 		"definition": "Executable entity in Robot Framework similar to a test case but used for non-testing automation such as RPA workflows, defined in a `*** Tasks ***` section."
 	},
 	{
 		"term": "Test Setup",
 		"aliases": ["Task Setup"],
 		"abbreviation": "",
-		"definition": "Keyword executed before an individual test or task starts to prepare preconditions specific to that test|task."
+		"definition": "Keyword executed before an individual test or task starts to prepare preconditions specific to that test or task."
 	},
 	{
 		"term": "Test Teardown",
 		"aliases": ["Task Teardown"],
 		"abbreviation": "",
-		"definition": "Keyword executed after an individual test or task finishes to clean up resources specific to that test|task."
+		"definition": "Keyword executed after an individual test or task finishes to clean up resources specific to that test or task."
 	},
 	{
 		"term": "Test Template",
 		"aliases": ["Task Template"],
 		"abbreviation": "",
-		"definition": "Setting that defines a keyword used as a template for multiple tests|tasks, where each row of data calls the template keyword with different arguments."
+		"definition": "Setting that defines a keyword used as a template for multiple tests or tasks, where each row of data calls the template keyword with different arguments."
 	},
 	{
 		"term": "Test Case",
-		"aliases": ["Task"],
-		"abbreviation": "Test",
+		"aliases": ["Test"],
+		"abbreviation": "",
 		"definition": "Executable specification in Robot Framework that verifies some aspect of system behavior and is defined in a `*** Test Cases ***` section."
 	},
 	{
@@ -465,7 +477,7 @@
 		"term": "Variable Scope",
 		"aliases": [],
 		"abbreviation": "",
-		"definition": "Visibility and lifetime of a variable (such as global, suite, test|task, or local) during a Robot Framework execution."
+		"definition": "Visibility and lifetime of a variable (such as global, suite, test or task, or local) during a Robot Framework execution."
 	},
 	{
 		"term": "WHILE Loop",