@serenity-js/web 3.25.0 → 3.25.2

package/src/screenplay/models/selectors/By.ts

@@ -9,8 +9,8 @@ import { ByTagName } from './ByTagName';
 import { ByXPath } from './ByXPath';
 
 /**
- * `By` produces a {@apilink Selector} used to locate a {@apilink PageElement} or {@apilink PageElements} on a web page.
- * Selectors can be defined using a static value or a {@link Question} to be resolved at runtime.
+ * `By` produces a [`Selector`](https://serenity-js.org/api/web/class/Selector/) used to locate a [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) or [`PageElement`](https://serenity-js.org/api/web/class/PageElements/) on a web page.
+ * Selectors can be defined using a static value or a [`Question`](https://serenity-js.org/api/core/class/Question/) to be resolved at runtime.
  *
  * ### Defining a selector using a static value
  *
@@ -30,11 +30,11 @@ import { ByXPath } from './ByXPath';
  *
  * ### Defining a selector using a Question
  *
- * Each method on this class accepts an {@link Answerable} to allow for dynamic resolution of the selector.
+ * Each method on this class accepts an [`Answerable`](https://serenity-js.org/api/core/#Answerable) to allow for dynamic resolution of the selector.
  * This can be useful when the selector is not known at the time of writing the test, or when the selector
  * needs to be calculated based on the state of the system under test.
  *
- * The example below demonstrates how to use {@link q} to define a selector that includes a dynamic value.
+ * The example below demonstrates how to use [`q`](https://serenity-js.org/api/core/function/q/) to define a selector that includes a dynamic value.
  *
  * ```typescript
  * import { q } from '@serenity-js/core'
@@ -49,17 +49,17 @@ import { ByXPath } from './ByXPath';
  * ```
  *
  * ### Learn more
- * - [Page Element Query Language](/handbook/web-testing/page-element-query-language)
- * - {@apilink PageElement}
- * - {@apilink PageElements}
- * - {@apilink q}
+ * - [Page Element Query Language](https://serenity-js.org/handbook/web-testing/page-element-query-language)
+ * - [`PageElement`](https://serenity-js.org/api/web/class/PageElement/)
+ * - [`PageElement`](https://serenity-js.org/api/web/class/PageElements/)
+ * - [`q`](https://serenity-js.org/api/core/function/q/)
  *
  * @group Models
  */
 export class By {
 
     /**
-     * Locates a {@apilink PageElement} using a [CSS selector](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors).
+     * Locates a [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) using a [CSS selector](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors).
      *
      * @param selector
      */
@@ -71,7 +71,7 @@ export class By {
     }
 
     /**
-     * Locates a {@apilink PageElement} with a given [`innerText`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/innerText)
+     * Locates a [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) with a given [`innerText`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/innerText)
      * using a [CSS selector](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors).
      *
      * @param selector
@@ -86,7 +86,7 @@ export class By {
     }
 
     /**
-     * Locates a {@apilink PageElement} using a [CSS selector](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors)
+     * Locates a [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) using a [CSS selector](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors)
      * capable of piercing [shadow DOM](https://developer.mozilla.org/en-US/docs/Web/Web_Components/Using_shadow_DOM)-piercing
      *
      * @param selector
@@ -99,7 +99,7 @@ export class By {
     }
 
     /**
-     * Locates a {@apilink PageElement} using its [id](https://developer.mozilla.org/en-US/docs/Web/CSS/ID_selectors).
+     * Locates a [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) using its [id](https://developer.mozilla.org/en-US/docs/Web/CSS/ID_selectors).
      *
      * @param selector
      */
@@ -111,7 +111,7 @@ export class By {
     }
 
     /**
-     * Locates a {@apilink PageElement} using the name of its [HTML tag](https://developer.mozilla.org/en-US/docs/Web/HTML/Element).
+     * Locates a [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) using the name of its [HTML tag](https://developer.mozilla.org/en-US/docs/Web/HTML/Element).
      *
      * @param selector
      */
@@ -123,7 +123,7 @@ export class By {
     }
 
     /**
-     * Locates a {@apilink PageElement} using an [XPath selector](https://developer.mozilla.org/en-US/docs/Web/XPath).
+     * Locates a [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) using an [XPath selector](https://developer.mozilla.org/en-US/docs/Web/XPath).
      *
      * @param selector
      */

package/src/screenplay/models/selectors/ByCss.ts

@@ -1,9 +1,9 @@
 import { Selector } from './Selector';
 
 /**
- * Locates a {@apilink PageElement} using a [CSS selector](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors).
+ * Locates a [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) using a [CSS selector](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors).
  *
- * **Pro tip:** Instantiate using {@apilink By.css}
+ * **Pro tip:** Instantiate using [`By.css`](https://serenity-js.org/api/web/class/By/#css)
  *
  * @group Models
  */

package/src/screenplay/models/selectors/ByCssContainingText.ts

@@ -1,10 +1,10 @@
 import { Selector } from './Selector';
 
 /**
- * Locates a {@apilink PageElement} with a given [`innerText`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/innerText)
+ * Locates a [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) with a given [`innerText`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/innerText)
  * using a [CSS selector](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors).
  *
- * **Pro tip:** Instantiate using {@apilink By.cssContainingText}
+ * **Pro tip:** Instantiate using [`By.cssContainingText`](https://serenity-js.org/api/web/class/By/#cssContainingText)
  *
  * @group Models
  */

package/src/screenplay/models/selectors/ByDeepCss.ts

@@ -1,10 +1,10 @@
 import { Selector } from './Selector';
 
 /**
- * Locates a {@apilink PageElement} using a [CSS selector](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors)
+ * Locates a [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) using a [CSS selector](https://developer.mozilla.org/en-US/docs/Learn/CSS/Building_blocks/Selectors)
  * capable of piercing [shadow DOM](https://developer.mozilla.org/en-US/docs/Web/Web_Components/Using_shadow_DOM)-piercing
  *
- * **Pro tip:** Instantiate using {@apilink By.deepCss}
+ * **Pro tip:** Instantiate using [`By.deepCss`](https://serenity-js.org/api/web/class/By/#deepCss)
  *
  * @group Models
  */

package/src/screenplay/models/selectors/ById.ts

@@ -1,9 +1,9 @@
 import { Selector } from './Selector';
 
 /**
- * Locates a {@apilink PageElement} using its [id](https://developer.mozilla.org/en-US/docs/Web/CSS/ID_selectors).
+ * Locates a [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) using its [id](https://developer.mozilla.org/en-US/docs/Web/CSS/ID_selectors).
  *
- * **Pro tip:** Instantiate using {@apilink By.id}
+ * **Pro tip:** Instantiate using [`By.id`](https://serenity-js.org/api/web/class/By/#id)
  *
  * @group Models
  */

package/src/screenplay/models/selectors/ByTagName.ts

@@ -1,9 +1,9 @@
 import { Selector } from './Selector';
 
 /**
- * Locates a {@apilink PageElement} using the name of its [HTML tag](https://developer.mozilla.org/en-US/docs/Web/HTML/Element).
+ * Locates a [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) using the name of its [HTML tag](https://developer.mozilla.org/en-US/docs/Web/HTML/Element).
  *
- * **Pro tip:** Instantiate using {@apilink By.tagName}
+ * **Pro tip:** Instantiate using [`By.tagName`](https://serenity-js.org/api/web/class/By/#tagName)
  *
  * @group Models
  */

package/src/screenplay/models/selectors/ByXPath.ts

@@ -1,9 +1,9 @@
 import { Selector } from './Selector';
 
 /**
- * Locates a {@apilink PageElement} using an [XPath selector](https://developer.mozilla.org/en-US/docs/Web/XPath).
+ * Locates a [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) using an [XPath selector](https://developer.mozilla.org/en-US/docs/Web/XPath).
  *
- * **Pro tip:** Instantiate using {@apilink By.xpath}
+ * **Pro tip:** Instantiate using [`By.xpath`](https://serenity-js.org/api/web/class/By/#xpath)
  *
  * @group Models
  */

package/src/screenplay/models/selectors/Selector.ts

@@ -2,7 +2,7 @@ import { f } from '@serenity-js/core';
 import { TinyType } from 'tiny-types';
 
 /**
- * Describes a selector you use to identify a {@apilink PageElement} or a group of {@apilink PageElements}.
+ * Describes a selector you use to identify a [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) or a group of [`PageElement`](https://serenity-js.org/api/web/class/PageElements/).
  *
  * @group Models
  */

package/src/screenplay/questions/Attribute.ts

@@ -4,8 +4,8 @@ import { d, LogicError, Question, the } from '@serenity-js/core';
 import { PageElement } from '../models';
 
 /**
- * Uses the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
- * the value of the specified HTML attribute of a given {@apilink PageElement}.
+ * Uses the [actor's](https://serenity-js.org/api/core/class/Actor/) [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/) to retrieve
+ * the value of the specified HTML attribute of a given [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
  *
  * ## Example widget
  *
@@ -17,7 +17,7 @@ import { PageElement } from '../models';
  * </ul>
  * ```
  *
- * ## Retrieve an HTML attribute of a given {@apilink PageElement}
+ * ## Retrieve an HTML attribute of a given [`PageElement`](https://serenity-js.org/api/web/class/PageElement/)
  *
  * ```ts
  * import { actorCalled } from '@serenity-js/core'
@@ -37,7 +37,7 @@ import { PageElement } from '../models';
  *   )
  * ```
  *
- * ## Using `Attribute` as {@apilink QuestionAdapter}
+ * ## Using `Attribute` as [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter)
  *
  * ```ts
  * import { actorCalled } from '@serenity-js/core'
@@ -57,7 +57,7 @@ import { PageElement } from '../models';
  * )
  * ```
  *
- * ## Using as filter in {@apilink PageElements|Page Element Query Language}
+ * ## Using as filter in [Page Element Query Language](https://serenity-js.org/handbook/web-testing/page-element-query-language/)
  *
  * ```ts
  * import { actorCalled } from '@serenity-js/core'
@@ -88,10 +88,10 @@ import { PageElement } from '../models';
  * ```
  *
  * ## Learn more
- * - {@apilink BrowseTheWeb}
- * - {@apilink MetaQuestion}
- * - {@apilink QuestionAdapter}
- * - {@apilink Question}
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`MetaQuestion`](https://serenity-js.org/api/core/interface/MetaQuestion/)
+ * - [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter)
+ * - [`Question`](https://serenity-js.org/api/core/class/Question/)
  *
  * @group Questions
  */
@@ -100,9 +100,9 @@ export class Attribute<Native_Element_Type>
     implements MetaQuestion<PageElement<Native_Element_Type>, Question<Promise<string>>>, Optional
 {
     /**
-     * Instantiates a {@apilink Question} that uses
-     * the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
-     * the value of the specified HTML attribute of a given {@apilink PageElement}.
+     * Instantiates a [`Question`](https://serenity-js.org/api/core/class/Question/) that uses
+     * the [actor's](https://serenity-js.org/api/core/class/Actor/) [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/) to retrieve
+     * the value of the specified HTML attribute of a given [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
      *
      * @param name
      *  The name of the attribute to retrieve
@@ -125,7 +125,7 @@ export class Attribute<Native_Element_Type>
      * Resolves to the value of an HTML attribute of the `pageElement`.
      *
      * #### Learn more
-     * - {@apilink MetaQuestion}
+     * - [`MetaQuestion`](https://serenity-js.org/api/core/interface/MetaQuestion/)
      *
      * @param pageElement
      */

package/src/screenplay/questions/ComputedStyle.ts

@@ -12,8 +12,8 @@ import { BrowseTheWeb } from '../abilities';
 import { PageElement } from '../models';
 
 /**
- * Uses the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
- * the value of the specified computed style property of a given {@apilink PageElement}.
+ * Uses the [actor's](https://serenity-js.org/api/core/class/Actor/) [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/) to retrieve
+ * the value of the specified computed style property of a given [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
  *
  * ## Example widget
  *
@@ -25,7 +25,7 @@ import { PageElement } from '../models';
  * </ul>
  * ```
  *
- * ## Retrieve a computed style property of a given {@apilink PageElement}
+ * ## Retrieve a computed style property of a given [`PageElement`](https://serenity-js.org/api/web/class/PageElement/)
  *
  * ```ts
  * import { actorCalled } from '@serenity-js/core'
@@ -44,7 +44,7 @@ import { PageElement } from '../models';
  * )
  * ```
  *
- * ## Using `ComputedStyle` as {@apilink QuestionAdapter}
+ * ## Using `ComputedStyle` as [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter)
  *
  * ```ts
  * import { actorCalled } from '@serenity-js/core'
@@ -63,7 +63,7 @@ import { PageElement } from '../models';
  * )
  * ```
  *
- * ## Using as filter in {@apilink PageElements|Page Element Query Language}
+ * ## Using as filter in [Page Element Query Language](https://serenity-js.org/handbook/web-testing/page-element-query-language/)
  *
  * ```ts
  * import { actorCalled } from '@serenity-js/core'
@@ -94,10 +94,10 @@ import { PageElement } from '../models';
  * ```
  *
  * ## Learn more
- * - {@apilink BrowseTheWeb}
- * - {@apilink MetaQuestion}
- * - {@apilink QuestionAdapter}
- * - {@apilink Question}
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`MetaQuestion`](https://serenity-js.org/api/core/interface/MetaQuestion/)
+ * - [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter)
+ * - [`Question`](https://serenity-js.org/api/core/class/Question/)
  *
  * @group Questions
  */
@@ -106,9 +106,9 @@ export class ComputedStyle<Native_Element_Type>
     implements MetaQuestion<PageElement<Native_Element_Type>, Question<Promise<string>>>
 {
     /**
-     * Instantiates a {@apilink Question} that uses
-     * the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
-     * the value of the specified computed style property of a given {@apilink PageElement}.
+     * Instantiates a [`Question`](https://serenity-js.org/api/core/class/Question/) that uses
+     * the [actor's](https://serenity-js.org/api/core/class/Actor/) [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/) to retrieve
+     * the value of the specified computed style property of a given [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
      *
      * @param name
      *  The name of the computed style property to retrieve
@@ -130,9 +130,9 @@ export class ComputedStyle<Native_Element_Type>
     }
 
     /**
-     * Instantiates a {@apilink Question} that uses
-     * the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
-     * the value of the specified computed style property of the specified pseudo-element of a given {@apilink PageElement}.
+     * Instantiates a [`Question`](https://serenity-js.org/api/core/class/Question/) that uses
+     * the [actor's](https://serenity-js.org/api/core/class/Actor/) [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/) to retrieve
+     * the value of the specified computed style property of the specified pseudo-element of a given [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
      *
      * @param pseudoElement
      *  The pseudo-element to retrieve the computed style property from, such as `::before` or `::after`
@@ -151,7 +151,7 @@ export class ComputedStyle<Native_Element_Type>
      * Resolves to the value of a computed style property of the `pageElement`.
      *
      * #### Learn more
-     * - {@apilink MetaQuestion}
+     * - [`MetaQuestion`](https://serenity-js.org/api/core/interface/MetaQuestion/)
      *
      * @param pageElement
      */

package/src/screenplay/questions/CssClasses.ts

@@ -4,9 +4,9 @@ import { Question, the } from '@serenity-js/core';
 import { PageElement } from '../models';
 
 /**
- * Uses the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
+ * Uses the [actor's](https://serenity-js.org/api/core/class/Actor/) [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/) to retrieve
  * a list of [CSS classes](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes#attr-class)
- * of a given {@apilink PageElement}.
+ * of a given [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
  *
  * ## Example widget
  *
@@ -18,7 +18,7 @@ import { PageElement } from '../models';
  * </ul>
  * ```
  *
- * ## Retrieve CSS classes of a given {@apilink PageElement}
+ * ## Retrieve CSS classes of a given [`PageElement`](https://serenity-js.org/api/web/class/PageElement/)
  *
  * ```ts
  * import { actorCalled } from '@serenity-js/core'
@@ -38,7 +38,7 @@ import { PageElement } from '../models';
  *   )
  * ```
  *
- * ## Using CssClasses as {@apilink QuestionAdapter}
+ * ## Using CssClasses as [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter)
  *
  * ```ts
  * import { actorCalled } from '@serenity-js/core'
@@ -62,7 +62,7 @@ import { PageElement } from '../models';
  *   )
  * ```
  *
- * ## Using as filter in {@apilink PageElements|Page Element Query Language}
+ * ## Using as filter in [Page Element Query Language](https://serenity-js.org/handbook/web-testing/page-element-query-language/)
  *
  * ```ts
  * import { actorCalled } from '@serenity-js/core'
@@ -89,23 +89,23 @@ import { PageElement } from '../models';
  * ```
  *
  * ## Learn more
- * - {@apilink BrowseTheWeb}
- * - {@apilink MetaQuestion}
- * - {@apilink QuestionAdapter}
- * - {@apilink Question}
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`MetaQuestion`](https://serenity-js.org/api/core/interface/MetaQuestion/)
+ * - [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter)
+ * - [`Question`](https://serenity-js.org/api/core/class/Question/)
  *
  * @group Questions
  */
 export class CssClasses {
 
     /**
-     * Instantiates a {@apilink Question} that uses
-     * the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
+     * Instantiates a [`Question`](https://serenity-js.org/api/core/class/Question/) that uses
+     * the [actor's](https://serenity-js.org/api/core/class/Actor/) [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/) to retrieve
      * a list of [CSS classes](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes#attr-class)
-     * of a given {@apilink PageElement}.
+     * of a given [`PageElement`](https://serenity-js.org/api/web/class/PageElement/).
      *
      * #### Learn more
-     * - {@apilink MetaQuestion}
+     * - [`MetaQuestion`](https://serenity-js.org/api/core/interface/MetaQuestion/)
      *
      * @param pageElement
      */

package/src/screenplay/questions/LastScriptExecution.ts

@@ -4,8 +4,8 @@ import { Question } from '@serenity-js/core';
 import { BrowseTheWeb } from '../abilities';
 
 /**
- * Uses the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
- * a returns the result of the last script executed via {@apilink ExecuteScript}.
+ * Uses the [actor's](https://serenity-js.org/api/core/class/Actor/) [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/) to retrieve
+ * a returns the result of the last script executed via [`ExecuteScript`](https://serenity-js.org/api/web/class/ExecuteScript/).
  *
  * ## Executing a script and reading the result
  *
@@ -21,7 +21,7 @@ import { BrowseTheWeb } from '../abilities';
  *   )
  * ```
  *
- * ## Using LastScriptExecution as {@apilink QuestionAdapter}
+ * ## Using LastScriptExecution as [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter)
  *
  * ```ts
  * import { actorCalled } from '@serenity-js/core'
@@ -39,16 +39,16 @@ import { BrowseTheWeb } from '../abilities';
  * ```
  *
  * ## Learn more
- * - {@apilink ExecuteScript}
- * - {@apilink BrowseTheWeb}
- * - {@apilink QuestionAdapter}
+ * - [`ExecuteScript`](https://serenity-js.org/api/web/class/ExecuteScript/)
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter)
  *
  * @group Questions
  */
 export class LastScriptExecution {
 
     /**
-     * Enables asserting on the result of a function executed via {@apilink ExecuteScript}.
+     * Enables asserting on the result of a function executed via [`ExecuteScript`](https://serenity-js.org/api/web/class/ExecuteScript/).
      */
     static result<R>(): QuestionAdapter<R> {
         return Question.about(`last script execution result`, async actor => {

package/src/screenplay/questions/Selected.ts

@@ -4,22 +4,22 @@ import { Question, the } from '@serenity-js/core';
 import type { PageElement } from '../models';
 
 /**
- * Uses the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
+ * Uses the [actor's](https://serenity-js.org/api/core/class/Actor/) [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/) to retrieve
  * options and values selected in a
  * [HTML `<select>` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/select).
  *
  * ## Learn more
- * - {@apilink Select}
- * - {@apilink BrowseTheWeb}
- * - {@apilink QuestionAdapter}
- * - {@apilink Question}
+ * - [`Select`](https://serenity-js.org/api/web/class/Select/)
+ * - [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/)
+ * - [`QuestionAdapter`](https://serenity-js.org/api/core/#QuestionAdapter)
+ * - [`Question`](https://serenity-js.org/api/core/class/Question/)
  *
  * @group Questions
  */
 export class Selected {
 
     /**
-     * Uses the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
+     * Uses the [actor's](https://serenity-js.org/api/core/class/Actor/) [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/) to retrieve
      * a single [option](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option)
      * selected in an [HTML `<select>` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/select).
      *
@@ -61,10 +61,10 @@ export class Selected {
      * ```
      *
      * #### Learn more
-     * - {@apilink Select.value}
+     * - [`Select.value`](https://serenity-js.org/api/web/class/Select/#value)
      *
      * @param pageElement
-     *  A {@apilink PageElement} identifying the `<select>` element of interest
+     *  A [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) identifying the `<select>` element of interest
      */
     static valueOf(pageElement: Answerable<PageElement>): QuestionAdapter<string> {
         return Question.about(the`value selected in ${ pageElement }`, async actor => {
@@ -78,7 +78,7 @@ export class Selected {
     }
 
     /**
-     * Uses the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
+     * Uses the [actor's](https://serenity-js.org/api/core/class/Actor/) [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/) to retrieve
      * values of [options](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option)
      * selected in an [HTML `<select multiple>` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/select#attr-multiple)
      *
@@ -120,10 +120,10 @@ export class Selected {
      * ```
      *
      * #### Learn more
-     * - {@apilink Select.values}
+     * - [`Select.values`](https://serenity-js.org/api/web/class/Select/#values)
      *
      * @param pageElement
-     *  A {@apilink PageElement} identifying the `<select>` element of interest
+     *  A [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) identifying the `<select>` element of interest
      */
     static valuesOf(pageElement: Answerable<PageElement>): QuestionAdapter<Array<string>> {
         return Question.about(the`values selected in ${ pageElement }`, async actor => {
@@ -138,7 +138,7 @@ export class Selected {
     }
 
     /**
-     * Uses the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
+     * Uses the [actor's](https://serenity-js.org/api/core/class/Actor/) [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/) to retrieve
      * a single option selected in an [HTML `<select>` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/select#attr-multiple)
      *
      * #### Example widget
@@ -181,10 +181,10 @@ export class Selected {
      * ```
      *
      * #### Learn more
-     * - {@apilink Select.option}
+     * - [`Select.option`](https://serenity-js.org/api/web/class/Select/#option)
      *
      * @param pageElement
-     *  A {@apilink PageElement} identifying the `<select>` element of interest
+     *  A [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) identifying the `<select>` element of interest
      */
     static optionIn(pageElement: Answerable<PageElement>): QuestionAdapter<string> {
         return Question.about(the`option selected in ${ pageElement }`, async actor => {
@@ -199,7 +199,7 @@ export class Selected {
     }
 
     /**
-     * Uses the {@apilink Actor|actor's} {@apilink Ability|ability} to {@apilink BrowseTheWeb} to retrieve
+     * Uses the [actor's](https://serenity-js.org/api/core/class/Actor/) [ability](https://serenity-js.org/api/core/class/Ability/) to [`BrowseTheWeb`](https://serenity-js.org/api/web/class/BrowseTheWeb/) to retrieve
      * options selected in an [HTML `<select multiple>` element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/select#attr-multiple)
      *
      * #### Example widget
@@ -242,10 +242,10 @@ export class Selected {
      * ```
      *
      * #### Learn more
-     * - {@apilink Select.options}
+     * - [`Select.options`](https://serenity-js.org/api/web/class/Select/#options)
      *
      * @param pageElement
-     *  A {@apilink PageElement} identifying the `<select>` element of interest
+     *  A [`PageElement`](https://serenity-js.org/api/web/class/PageElement/) identifying the `<select>` element of interest
      */
     static optionsIn(pageElement: Answerable<PageElement>): QuestionAdapter<Array<string>> {
         return Question.about(the`options selected in ${ pageElement }`, async actor => {