fix: jsdoc (#3824)

## Proposed change

<!--
Please include a summary of the changes and the related issue.
Please also include relevant motivation and context.
-->

## Related issues

<!--
Please make sure to follow the [contribution
guidelines](https://github.com/amadeus-digital/Otter/blob/main/CONTRIBUTING.md)
-->

*- No issue associated -*

<!-- * 🐛 Fix #issue -->
<!-- * 🐛 Fix resolves #issue -->
<!-- * 🚀 Feature #issue -->
<!-- * 🚀 Feature resolves #issue -->
<!-- *  Pull Request #issue -->

Author: fpaul-1A

packages/@ama-mcp/github/src/find-repositories-using-library/index.ts

@@ -28,7 +28,7 @@ import type {
 export interface GetRepositoriesUsingLibraryOptions extends CacheToolOptions, GithubToolOptions, ToolDefinition {
   /**
    * Scopes to look for when searching for repositories
-   * (e.g. for @ama-mcp/github, the scope is ama-mcp)
+   * (e.g. for `@ama-mcp/github`, the scope is ama-mcp)
    * Limit to 10 scopes to avoid hitting GitHub search API rate limit
    * @example ['ama-mcp', 'o3r']
    */

packages/@ama-mfe/ng-utils/src/messages/available-sender.ts

@@ -6,7 +6,7 @@ import type {
 } from '../managers/interfaces';
 
 /**
- * Gets the available consumers and formats them into a {@see DeclareMessages} object.
+ * Gets the available consumers and formats them into a {@link DeclareMessages} object.
  * @param consumers - The list of registered message consumers.
  * @returns The formatted DeclareMessages object.
  */

packages/@ama-mfe/ng-utils/src/navigation/restore-route-pipe.ts

@@ -54,7 +54,7 @@ export class RestoreRoute implements PipeTransform {
   /**
    * Transforms the given URL or SafeResourceUrl by appending query parameters and adjusting the pathname.
    * @param url - The URL or SafeResourceUrl to be transformed.
-   * @param options - Optional parameters to control the transformation. {@see RestoreRouteOptions}
+   * @param options - Optional parameters to control the transformation. {@link RestoreRouteOptions}
    * @returns - The transformed SafeResourceUrl or undefined if the input URL is invalid.
    */
   public transform(url: string, options?: Partial<RestoreRouteOptions>): string;

packages/@ama-mfe/ng-utils/src/navigation/routing-service.ts

@@ -115,7 +115,7 @@ export class RoutingService implements MessageProducer<NavigationMessage>, Messa
    * Handles embedded routing by listening to router events and sending navigation messages to the connected endpoints.
    * It can be a parent window or another iframe
    * @note - This method has to be called in an injection context
-   * @param options - Optional parameters to control the routing behavior {@see RoutingServiceOptions}.
+   * @param options - Optional parameters to control the routing behavior {@link RoutingServiceOptions}.
    */
   public handleEmbeddedRouting(options?: RoutingServiceOptions): void {
     const subRouteOnly = options?.subRouteOnly ?? false;

packages/@ama-openapi/redocly-plugin/src/logger.mts

@@ -9,7 +9,7 @@ import type {
   RuleSeverity,
 } from '@redocly/openapi-core';
 
-/** Duplicate of Problem not exposed by @redocly/openapi-core */
+/** Duplicate of Problem not exposed by `@redocly/openapi-core` */
 type Problem = {
   message: string;
   suggest?: string[];

packages/@ama-sdk/client-fetch/src/plugins/perf-metric/perf-metric-fetch.ts

@@ -13,13 +13,13 @@ import type {
 
 /**
  * Performance metric mark associated to a call.
- * @deprecated use {@link CoreMark|Mark from @ama-sdk/core} instead. Will be removed in v15
+ * @deprecated use {@link CoreMark|Mark from `@ama-sdk/core`} instead. Will be removed in v15
  */
 export type Mark = CoreMark;
 
 /**
  * Options for the Performance Metric Plugin.
- * @deprecated use {@link CorePerformanceMetricOptions|PerformanceMetricOptions from @ama-sdk/core} instead. Will be removed in v15
+ * @deprecated use {@link CorePerformanceMetricOptions|PerformanceMetricOptions from `@ama-sdk/core`} instead. Will be removed in v15
  */
 export type PerformanceMetricOptions = CorePerformanceMetricOptions;
 

packages/@ama-sdk/client-fetch/src/plugins/timeout/timeout-fetch.ts

@@ -20,7 +20,7 @@ type ImpervaCaptchaMessageData = {
 };
 
 /**
- * Type to describe the timer status of the {@see TimeoutFetch} plugin.
+ * Type to describe the timer status of the {@link TimeoutFetch} plugin.
  * Today, only the stop and restart of the timer is supported which match the following events:
  * - stop: stop the timeout timer
  * - start: reset the timer and restart it
@@ -44,7 +44,7 @@ function isImpervaCaptchaMessage(message: any): message is ImpervaCaptchaMessage
  */
 export type TimeoutPauseEventHandler = ((timeoutPauseCallback: (timeoutStatus: TimeoutStatus) => void, context: any) => () => void);
 /**
- * Factory to generate a {@see TimeoutPauseEventHandler} depending on various configurations
+ * Factory to generate a {@link TimeoutPauseEventHandler} depending on various configurations
  */
 export type TimeoutPauseEventHandlerFactory<T> = (config?: Partial<T>) => TimeoutPauseEventHandler;
 

packages/@ama-sdk/core/schematics/ng-add/index.ts

@@ -44,7 +44,7 @@ const updateImports: Rule = (tree) => {
 const packageJsonPath = path.resolve(__dirname, '..', '..', 'package.json');
 
 /**
- * Rule to import all the necessary dependency to run an @ama-sdk based application
+ * Rule to import all the necessary dependency to run an `@ama-sdk` based application
  * Helps to migrate from previous versions with an import replacement
  * @param options schema options
  */
@@ -57,7 +57,7 @@ function ngAddFn(options: NgAddSchematicsSchema): Rule {
 }
 
 /**
- * Rule to import all the necessary dependency to run an @ama-sdk based application
+ * Rule to import all the necessary dependency to run an `@ama-sdk` based application
  * Helps to migrate from previous versions with an import replacement
  * @param options
  */

packages/@ama-sdk/core/src/fwk/core/api-client.ts

@@ -48,7 +48,7 @@ export interface RequestOptionsParameters {
 
 /**
  * API Client used by the SDK's APIs to call the server
- * The list of official clients is available in @ama-sdk/core {@link https://github.com/AmadeusITGroup/otter/tree/main/packages/%40ama-sdk/core/README.md#available-api-client|readme}
+ * The list of official clients is available in `@ama-sdk/core` {@link https://github.com/AmadeusITGroup/otter/tree/main/packages/%40ama-sdk/core/README.md#available-api-client|readme}
  */
 export interface ApiClient {
 

packages/@ama-sdk/schematics/schematics/code-generator/open-api-cli-generator/open-api-cli-generator.ts

@@ -15,7 +15,7 @@ import {
 } from './open-api-cli-options';
 
 /**
- * Manage the schematic to generate a sdk using the @openapitools/openapi-generator-cli
+ * Manage the schematic to generate a sdk using the `@openapitools/openapi-generator-cli`
  */
 export class OpenApiCliGenerator extends CodeGenerator<OpenApiCliOptions> {
   protected readonly packageManager: 'npm' | 'yarn';