diff --git a/src/openApi/v2/interfaces/OpenApi.ts b/src/openApi/v2/interfaces/OpenApi.ts
index 3fa3b5901..22b4fcc5f 100644
--- a/src/openApi/v2/interfaces/OpenApi.ts
+++ b/src/openApi/v2/interfaces/OpenApi.ts
@@ -10,7 +10,7 @@ import type { OpenApiSecurityScheme } from './OpenApiSecurityScheme';
 import type { OpenApiTag } from './OpenApiTag';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md
  */
 export interface OpenApi {
     basePath?: string;
diff --git a/src/openApi/v2/interfaces/OpenApiContact.ts b/src/openApi/v2/interfaces/OpenApiContact.ts
index 485e97a5e..074474086 100644
--- a/src/openApi/v2/interfaces/OpenApiContact.ts
+++ b/src/openApi/v2/interfaces/OpenApiContact.ts
@@ -1,5 +1,5 @@
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#contactObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/main/versions/2.0.md#contact-object
  */
 export interface OpenApiContact {
     name?: string;
diff --git a/src/openApi/v2/interfaces/OpenApiExample.ts b/src/openApi/v2/interfaces/OpenApiExample.ts
index 6af25277a..ca9de2808 100644
--- a/src/openApi/v2/interfaces/OpenApiExample.ts
+++ b/src/openApi/v2/interfaces/OpenApiExample.ts
@@ -1,5 +1,5 @@
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#exampleObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/main/versions/2.0.md#example-object
  */
 export interface OpenApiExample {
     [mimetype: string]: unknown;
diff --git a/src/openApi/v2/interfaces/OpenApiExternalDocs.ts b/src/openApi/v2/interfaces/OpenApiExternalDocs.ts
index dfcc9bb5c..0118ef362 100644
--- a/src/openApi/v2/interfaces/OpenApiExternalDocs.ts
+++ b/src/openApi/v2/interfaces/OpenApiExternalDocs.ts
@@ -1,5 +1,5 @@
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#externalDocumentationObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#external-documentation-object
  */
 export interface OpenApiExternalDocs {
     description?: string;
diff --git a/src/openApi/v2/interfaces/OpenApiHeader.ts b/src/openApi/v2/interfaces/OpenApiHeader.ts
index 4f490c439..1ee06d6f3 100644
--- a/src/openApi/v2/interfaces/OpenApiHeader.ts
+++ b/src/openApi/v2/interfaces/OpenApiHeader.ts
@@ -2,7 +2,7 @@ import type { Dictionary } from '../../../types/generic';
 import type { OpenApiItems } from './OpenApiItems';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#headerObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#header-object
  */
 export interface OpenApiHeader {
     description?: string;
diff --git a/src/openApi/v2/interfaces/OpenApiInfo.ts b/src/openApi/v2/interfaces/OpenApiInfo.ts
index 208dec9fd..7e4abedcc 100644
--- a/src/openApi/v2/interfaces/OpenApiInfo.ts
+++ b/src/openApi/v2/interfaces/OpenApiInfo.ts
@@ -2,7 +2,7 @@ import type { OpenApiContact } from './OpenApiContact';
 import type { OpenApiLicense } from './OpenApiLicense';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#infoObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#info-object
  */
 export interface OpenApiInfo {
     title: string;
diff --git a/src/openApi/v2/interfaces/OpenApiItems.ts b/src/openApi/v2/interfaces/OpenApiItems.ts
index 93dc2d76f..5b861b469 100644
--- a/src/openApi/v2/interfaces/OpenApiItems.ts
+++ b/src/openApi/v2/interfaces/OpenApiItems.ts
@@ -1,7 +1,7 @@
 import type { WithEnumExtension } from '../../../types/client';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#itemsObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#items-object)
  */
 export interface OpenApiItems extends WithEnumExtension {
     type?: string;
diff --git a/src/openApi/v2/interfaces/OpenApiLicense.ts b/src/openApi/v2/interfaces/OpenApiLicense.ts
index 44fc2f4a3..10d0c3f6d 100644
--- a/src/openApi/v2/interfaces/OpenApiLicense.ts
+++ b/src/openApi/v2/interfaces/OpenApiLicense.ts
@@ -1,5 +1,5 @@
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#licenseObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#license-object
  */
 export interface OpenApiLicense {
     name: string;
diff --git a/src/openApi/v2/interfaces/OpenApiOperation.ts b/src/openApi/v2/interfaces/OpenApiOperation.ts
index aa811bd3f..7ff46a9bf 100644
--- a/src/openApi/v2/interfaces/OpenApiOperation.ts
+++ b/src/openApi/v2/interfaces/OpenApiOperation.ts
@@ -4,7 +4,7 @@ import type { OpenApiResponses } from './OpenApiResponses';
 import type { OpenApiSecurityRequirement } from './OpenApiSecurityRequirement';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#operationObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#operation-object
  */
 export interface OpenApiOperation {
     tags?: string[];
diff --git a/src/openApi/v2/interfaces/OpenApiParameter.ts b/src/openApi/v2/interfaces/OpenApiParameter.ts
index c626fb96d..8309812b8 100644
--- a/src/openApi/v2/interfaces/OpenApiParameter.ts
+++ b/src/openApi/v2/interfaces/OpenApiParameter.ts
@@ -5,7 +5,7 @@ import type { OpenApiReference } from './OpenApiReference';
 import type { OpenApiSchema } from './OpenApiSchema';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#parameterObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#parameter-object
  */
 export interface OpenApiParameter extends OpenApiReference, WithEnumExtension, WithNullableExtension {
     name: string;
diff --git a/src/openApi/v2/interfaces/OpenApiPath.ts b/src/openApi/v2/interfaces/OpenApiPath.ts
index 62d8e7552..04abd8711 100644
--- a/src/openApi/v2/interfaces/OpenApiPath.ts
+++ b/src/openApi/v2/interfaces/OpenApiPath.ts
@@ -3,7 +3,7 @@ import type { OpenApiParameter } from './OpenApiParameter';
 import type { OpenApiReference } from './OpenApiReference';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#pathItemObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#path-item-object
  */
 export interface OpenApiPath extends OpenApiReference {
     get?: OpenApiOperation;
diff --git a/src/openApi/v2/interfaces/OpenApiReference.ts b/src/openApi/v2/interfaces/OpenApiReference.ts
index cbf3253db..bac5386b7 100644
--- a/src/openApi/v2/interfaces/OpenApiReference.ts
+++ b/src/openApi/v2/interfaces/OpenApiReference.ts
@@ -1,5 +1,5 @@
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#referenceObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#reference-object
  */
 export interface OpenApiReference {
     $ref?: string;
diff --git a/src/openApi/v2/interfaces/OpenApiResponse.ts b/src/openApi/v2/interfaces/OpenApiResponse.ts
index df250ad50..0ab7e1704 100644
--- a/src/openApi/v2/interfaces/OpenApiResponse.ts
+++ b/src/openApi/v2/interfaces/OpenApiResponse.ts
@@ -5,7 +5,7 @@ import type { OpenApiReference } from './OpenApiReference';
 import type { OpenApiSchema } from './OpenApiSchema';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#responseObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#response-object
  */
 export interface OpenApiResponse extends OpenApiReference {
     description: string;
diff --git a/src/openApi/v2/interfaces/OpenApiResponses.ts b/src/openApi/v2/interfaces/OpenApiResponses.ts
index 8f67edc50..27d14bace 100644
--- a/src/openApi/v2/interfaces/OpenApiResponses.ts
+++ b/src/openApi/v2/interfaces/OpenApiResponses.ts
@@ -1,7 +1,7 @@
 import type { OpenApiResponse } from './OpenApiResponse';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#responsesObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#responses-object
  */
 interface Response {
     [httpcode: string]: OpenApiResponse;
diff --git a/src/openApi/v2/interfaces/OpenApiSchema.ts b/src/openApi/v2/interfaces/OpenApiSchema.ts
index e0998dfa9..35b42d27f 100644
--- a/src/openApi/v2/interfaces/OpenApiSchema.ts
+++ b/src/openApi/v2/interfaces/OpenApiSchema.ts
@@ -6,7 +6,7 @@ import type { OpenApiReference } from './OpenApiReference';
 import type { OpenApiXml } from './OpenApiXml';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#schemaObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#schema-object
  */
 export interface OpenApiSchema extends OpenApiReference, WithEnumExtension, WithNullableExtension {
     title?: string;
diff --git a/src/openApi/v2/interfaces/OpenApiSecurityRequirement.ts b/src/openApi/v2/interfaces/OpenApiSecurityRequirement.ts
index 3c1ce9af6..969ea1bd3 100644
--- a/src/openApi/v2/interfaces/OpenApiSecurityRequirement.ts
+++ b/src/openApi/v2/interfaces/OpenApiSecurityRequirement.ts
@@ -1,5 +1,5 @@
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#securityRequirementObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#security-requirement-object
  */
 export interface OpenApiSecurityRequirement {
     [key: string]: string;
diff --git a/src/openApi/v2/interfaces/OpenApiSecurityScheme.ts b/src/openApi/v2/interfaces/OpenApiSecurityScheme.ts
index 51162103a..241bfc622 100644
--- a/src/openApi/v2/interfaces/OpenApiSecurityScheme.ts
+++ b/src/openApi/v2/interfaces/OpenApiSecurityScheme.ts
@@ -1,7 +1,7 @@
 import type { Dictionary } from '../../../types/generic';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#securitySchemeObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#security-scheme-object
  */
 export interface OpenApiSecurityScheme {
     type: 'basic' | 'apiKey' | 'oauth2';
diff --git a/src/openApi/v2/interfaces/OpenApiTag.ts b/src/openApi/v2/interfaces/OpenApiTag.ts
index 85063452a..bf2b2a3b6 100644
--- a/src/openApi/v2/interfaces/OpenApiTag.ts
+++ b/src/openApi/v2/interfaces/OpenApiTag.ts
@@ -1,7 +1,7 @@
 import type { OpenApiExternalDocs } from './OpenApiExternalDocs';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#tagObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#tag-object
  */
 export interface OpenApiTag {
     name: string;
diff --git a/src/openApi/v2/interfaces/OpenApiXml.ts b/src/openApi/v2/interfaces/OpenApiXml.ts
index 6bd8a1bcc..2131df0ce 100644
--- a/src/openApi/v2/interfaces/OpenApiXml.ts
+++ b/src/openApi/v2/interfaces/OpenApiXml.ts
@@ -1,5 +1,5 @@
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#xmlObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#xml-object
  */
 export interface OpenApiXml {
     name?: string;
diff --git a/src/openApi/v3/interfaces/OpenApi.ts b/src/openApi/v3/interfaces/OpenApi.ts
index da75eeff3..541adef1a 100644
--- a/src/openApi/v3/interfaces/OpenApi.ts
+++ b/src/openApi/v3/interfaces/OpenApi.ts
@@ -7,7 +7,7 @@ import type { OpenApiServer } from './OpenApiServer';
 import type { OpenApiTag } from './OpenApiTag';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md
  */
 export interface OpenApi {
     components?: OpenApiComponents;
diff --git a/src/openApi/v3/interfaces/OpenApiCallback.ts b/src/openApi/v3/interfaces/OpenApiCallback.ts
index 64a57f6ac..4cb508f9d 100644
--- a/src/openApi/v3/interfaces/OpenApiCallback.ts
+++ b/src/openApi/v3/interfaces/OpenApiCallback.ts
@@ -2,7 +2,7 @@ import type { OpenApiPath } from './OpenApiPath';
 import type { OpenApiReference } from './OpenApiReference';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#callbackObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#callback-object
  */
 interface Callback {
     [key: string]: OpenApiPath;
diff --git a/src/openApi/v3/interfaces/OpenApiComponents.ts b/src/openApi/v3/interfaces/OpenApiComponents.ts
index eeaa8a8b5..3aef8544b 100644
--- a/src/openApi/v3/interfaces/OpenApiComponents.ts
+++ b/src/openApi/v3/interfaces/OpenApiComponents.ts
@@ -10,7 +10,7 @@ import type { OpenApiSchema } from './OpenApiSchema';
 import type { OpenApiSecurityScheme } from './OpenApiSecurityScheme';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#componentsObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#components-object
  */
 export interface OpenApiComponents {
     schemas?: Dictionary<OpenApiSchema>;
diff --git a/src/openApi/v3/interfaces/OpenApiContact.ts b/src/openApi/v3/interfaces/OpenApiContact.ts
index a291268f9..e720a5e5e 100644
--- a/src/openApi/v3/interfaces/OpenApiContact.ts
+++ b/src/openApi/v3/interfaces/OpenApiContact.ts
@@ -1,5 +1,5 @@
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#contactObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#contact-object
  */
 export interface OpenApiContact {
     name?: string;
diff --git a/src/openApi/v3/interfaces/OpenApiDiscriminator.ts b/src/openApi/v3/interfaces/OpenApiDiscriminator.ts
index c878f2281..f7b52ce50 100644
--- a/src/openApi/v3/interfaces/OpenApiDiscriminator.ts
+++ b/src/openApi/v3/interfaces/OpenApiDiscriminator.ts
@@ -1,7 +1,7 @@
 import type { Dictionary } from '../../../types/generic';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#discriminatorObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#discriminator-object
  */
 export interface OpenApiDiscriminator {
     propertyName: string;
diff --git a/src/openApi/v3/interfaces/OpenApiEncoding.ts b/src/openApi/v3/interfaces/OpenApiEncoding.ts
index ffdacf15a..992d2b95d 100644
--- a/src/openApi/v3/interfaces/OpenApiEncoding.ts
+++ b/src/openApi/v3/interfaces/OpenApiEncoding.ts
@@ -2,7 +2,7 @@ import type { Dictionary } from '../../../types/generic';
 import type { OpenApiHeader } from './OpenApiHeader';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#encodingObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#encoding-object
  */
 export interface OpenApiEncoding {
     contentType?: string;
diff --git a/src/openApi/v3/interfaces/OpenApiExample.ts b/src/openApi/v3/interfaces/OpenApiExample.ts
index 89b05cea0..4a37a9b7d 100644
--- a/src/openApi/v3/interfaces/OpenApiExample.ts
+++ b/src/openApi/v3/interfaces/OpenApiExample.ts
@@ -1,7 +1,7 @@
 import type { OpenApiReference } from './OpenApiReference';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#exampleObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#example-object
  */
 export interface OpenApiExample extends OpenApiReference {
     summary?: string;
diff --git a/src/openApi/v3/interfaces/OpenApiExternalDocs.ts b/src/openApi/v3/interfaces/OpenApiExternalDocs.ts
index 3aaf18772..de0777086 100644
--- a/src/openApi/v3/interfaces/OpenApiExternalDocs.ts
+++ b/src/openApi/v3/interfaces/OpenApiExternalDocs.ts
@@ -1,5 +1,5 @@
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#externalDocumentationObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#external-documentation-object
  */
 export interface OpenApiExternalDocs {
     description?: string;
diff --git a/src/openApi/v3/interfaces/OpenApiHeader.ts b/src/openApi/v3/interfaces/OpenApiHeader.ts
index 0b07f9830..46c61cb81 100644
--- a/src/openApi/v3/interfaces/OpenApiHeader.ts
+++ b/src/openApi/v3/interfaces/OpenApiHeader.ts
@@ -4,7 +4,7 @@ import type { OpenApiReference } from './OpenApiReference';
 import type { OpenApiSchema } from './OpenApiSchema';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#headerObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#header-object
  */
 export interface OpenApiHeader extends OpenApiReference {
     description?: string;
diff --git a/src/openApi/v3/interfaces/OpenApiInfo.ts b/src/openApi/v3/interfaces/OpenApiInfo.ts
index 96fabd0c6..61ace589e 100644
--- a/src/openApi/v3/interfaces/OpenApiInfo.ts
+++ b/src/openApi/v3/interfaces/OpenApiInfo.ts
@@ -2,7 +2,7 @@ import type { OpenApiContact } from './OpenApiContact';
 import type { OpenApiLicense } from './OpenApiLicense';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#infoObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#info-object
  */
 export interface OpenApiInfo {
     title: string;
diff --git a/src/openApi/v3/interfaces/OpenApiLicense.ts b/src/openApi/v3/interfaces/OpenApiLicense.ts
index 9982f95c9..2ce0cebfe 100644
--- a/src/openApi/v3/interfaces/OpenApiLicense.ts
+++ b/src/openApi/v3/interfaces/OpenApiLicense.ts
@@ -1,5 +1,5 @@
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#licenseObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#license-object
  */
 export interface OpenApiLicense {
     name: string;
diff --git a/src/openApi/v3/interfaces/OpenApiLink.ts b/src/openApi/v3/interfaces/OpenApiLink.ts
index be17339e5..61c96227e 100644
--- a/src/openApi/v3/interfaces/OpenApiLink.ts
+++ b/src/openApi/v3/interfaces/OpenApiLink.ts
@@ -3,7 +3,7 @@ import type { OpenApiReference } from './OpenApiReference';
 import type { OpenApiServer } from './OpenApiServer';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#linkObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#link-object
  */
 export interface OpenApiLink extends OpenApiReference {
     operationRef?: string;
diff --git a/src/openApi/v3/interfaces/OpenApiMediaType.ts b/src/openApi/v3/interfaces/OpenApiMediaType.ts
index 1b7dd0f56..0672944fc 100644
--- a/src/openApi/v3/interfaces/OpenApiMediaType.ts
+++ b/src/openApi/v3/interfaces/OpenApiMediaType.ts
@@ -5,7 +5,7 @@ import type { OpenApiReference } from './OpenApiReference';
 import type { OpenApiSchema } from './OpenApiSchema';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#mediaTypeObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#media-type-object
  */
 export interface OpenApiMediaType extends OpenApiReference {
     schema?: OpenApiSchema;
diff --git a/src/openApi/v3/interfaces/OpenApiOAuthFlow.ts b/src/openApi/v3/interfaces/OpenApiOAuthFlow.ts
index 1f8124da1..d7a152122 100644
--- a/src/openApi/v3/interfaces/OpenApiOAuthFlow.ts
+++ b/src/openApi/v3/interfaces/OpenApiOAuthFlow.ts
@@ -1,7 +1,7 @@
 import type { Dictionary } from '../../../types/generic';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#oauthFlowObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#oauth-flow-object
  */
 export interface OpenApiOAuthFlow {
     authorizationUrl: string;
diff --git a/src/openApi/v3/interfaces/OpenApiOAuthFlows.ts b/src/openApi/v3/interfaces/OpenApiOAuthFlows.ts
index 87accfdb0..a06adabba 100644
--- a/src/openApi/v3/interfaces/OpenApiOAuthFlows.ts
+++ b/src/openApi/v3/interfaces/OpenApiOAuthFlows.ts
@@ -1,7 +1,7 @@
 import type { OpenApiOAuthFlow } from './OpenApiOAuthFlow';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#oauthFlowsObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#oauth-flows-object
  */
 export interface OpenApiOAuthFlows {
     implicit?: OpenApiOAuthFlow;
diff --git a/src/openApi/v3/interfaces/OpenApiOperation.ts b/src/openApi/v3/interfaces/OpenApiOperation.ts
index 0721c98c8..4f5bd9730 100644
--- a/src/openApi/v3/interfaces/OpenApiOperation.ts
+++ b/src/openApi/v3/interfaces/OpenApiOperation.ts
@@ -8,7 +8,7 @@ import type { OpenApiSecurityRequirement } from './OpenApiSecurityRequirement';
 import type { OpenApiServer } from './OpenApiServer';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#operationObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#operation-object
  */
 export interface OpenApiOperation {
     tags?: string[];
diff --git a/src/openApi/v3/interfaces/OpenApiParameter.ts b/src/openApi/v3/interfaces/OpenApiParameter.ts
index 63a78176d..22d3c32c9 100644
--- a/src/openApi/v3/interfaces/OpenApiParameter.ts
+++ b/src/openApi/v3/interfaces/OpenApiParameter.ts
@@ -4,7 +4,7 @@ import type { OpenApiReference } from './OpenApiReference';
 import type { OpenApiSchema } from './OpenApiSchema';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#parameterObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#parameter-object
  */
 export interface OpenApiParameter extends OpenApiReference {
     name: string;
diff --git a/src/openApi/v3/interfaces/OpenApiPath.ts b/src/openApi/v3/interfaces/OpenApiPath.ts
index 35a678469..4df44e472 100644
--- a/src/openApi/v3/interfaces/OpenApiPath.ts
+++ b/src/openApi/v3/interfaces/OpenApiPath.ts
@@ -3,7 +3,7 @@ import type { OpenApiParameter } from './OpenApiParameter';
 import type { OpenApiServer } from './OpenApiServer';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#pathItemObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#path-item-object
  */
 export interface OpenApiPath {
     delete?: OpenApiOperation;
diff --git a/src/openApi/v3/interfaces/OpenApiPaths.ts b/src/openApi/v3/interfaces/OpenApiPaths.ts
index 334e1bed6..912b326bf 100644
--- a/src/openApi/v3/interfaces/OpenApiPaths.ts
+++ b/src/openApi/v3/interfaces/OpenApiPaths.ts
@@ -1,7 +1,7 @@
 import type { OpenApiPath } from './OpenApiPath';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#pathsObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#paths-object
  */
 export interface OpenApiPaths {
     [path: string]: OpenApiPath;
diff --git a/src/openApi/v3/interfaces/OpenApiReference.ts b/src/openApi/v3/interfaces/OpenApiReference.ts
index e3a1c07ba..834768b51 100644
--- a/src/openApi/v3/interfaces/OpenApiReference.ts
+++ b/src/openApi/v3/interfaces/OpenApiReference.ts
@@ -1,5 +1,5 @@
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#referenceObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#reference-object
  */
 export interface OpenApiReference {
     $ref?: string;
diff --git a/src/openApi/v3/interfaces/OpenApiRequestBody.ts b/src/openApi/v3/interfaces/OpenApiRequestBody.ts
index 647134ed0..d909556fc 100644
--- a/src/openApi/v3/interfaces/OpenApiRequestBody.ts
+++ b/src/openApi/v3/interfaces/OpenApiRequestBody.ts
@@ -3,7 +3,7 @@ import type { OpenApiMediaType } from './OpenApiMediaType';
 import type { OpenApiReference } from './OpenApiReference';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#requestBodyObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#request-body-object
  */
 export interface OpenApiRequestBody extends OpenApiReference {
     'x-body-name'?: string;
diff --git a/src/openApi/v3/interfaces/OpenApiResponse.ts b/src/openApi/v3/interfaces/OpenApiResponse.ts
index c28cbf182..11b4c754f 100644
--- a/src/openApi/v3/interfaces/OpenApiResponse.ts
+++ b/src/openApi/v3/interfaces/OpenApiResponse.ts
@@ -5,7 +5,7 @@ import type { OpenApiMediaType } from './OpenApiMediaType';
 import type { OpenApiReference } from './OpenApiReference';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#responseObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#response-object
  */
 export interface OpenApiResponse extends OpenApiReference {
     description: string;
diff --git a/src/openApi/v3/interfaces/OpenApiResponses.ts b/src/openApi/v3/interfaces/OpenApiResponses.ts
index 5110d0853..1387a3af1 100644
--- a/src/openApi/v3/interfaces/OpenApiResponses.ts
+++ b/src/openApi/v3/interfaces/OpenApiResponses.ts
@@ -2,7 +2,7 @@ import type { OpenApiReference } from './OpenApiReference';
 import type { OpenApiResponse } from './OpenApiResponse';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#responsesObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#responses-object
  */
 interface Response {
     [httpcode: string]: OpenApiResponse;
diff --git a/src/openApi/v3/interfaces/OpenApiSchema.ts b/src/openApi/v3/interfaces/OpenApiSchema.ts
index 02a3517ff..69abc2ffc 100644
--- a/src/openApi/v3/interfaces/OpenApiSchema.ts
+++ b/src/openApi/v3/interfaces/OpenApiSchema.ts
@@ -6,7 +6,7 @@ import type { OpenApiReference } from './OpenApiReference';
 import type { OpenApiXml } from './OpenApiXml';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#schemaObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#schema-object
  */
 export interface OpenApiSchema extends OpenApiReference, WithEnumExtension {
     additionalProperties?: boolean | OpenApiSchema;
diff --git a/src/openApi/v3/interfaces/OpenApiSecurityRequirement.ts b/src/openApi/v3/interfaces/OpenApiSecurityRequirement.ts
index 147407a8e..5cbb39b3b 100644
--- a/src/openApi/v3/interfaces/OpenApiSecurityRequirement.ts
+++ b/src/openApi/v3/interfaces/OpenApiSecurityRequirement.ts
@@ -1,5 +1,5 @@
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#securityRequirementObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#security-requirement-object
  */
 export interface OpenApiSecurityRequirement {
     [name: string]: string;
diff --git a/src/openApi/v3/interfaces/OpenApiSecurityScheme.ts b/src/openApi/v3/interfaces/OpenApiSecurityScheme.ts
index 21cfd1c2b..3d2de67c5 100644
--- a/src/openApi/v3/interfaces/OpenApiSecurityScheme.ts
+++ b/src/openApi/v3/interfaces/OpenApiSecurityScheme.ts
@@ -2,7 +2,7 @@ import type { OpenApiOAuthFlows } from './OpenApiOAuthFlows';
 import type { OpenApiReference } from './OpenApiReference';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#securitySchemeObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#security-scheme-object
  */
 export interface OpenApiSecurityScheme extends OpenApiReference {
     type: 'apiKey' | 'http' | 'oauth2' | 'openIdConnect';
diff --git a/src/openApi/v3/interfaces/OpenApiServer.ts b/src/openApi/v3/interfaces/OpenApiServer.ts
index 1b1e329f9..bf2bfc283 100644
--- a/src/openApi/v3/interfaces/OpenApiServer.ts
+++ b/src/openApi/v3/interfaces/OpenApiServer.ts
@@ -2,7 +2,7 @@ import type { Dictionary } from '../../../types/generic';
 import type { OpenApiServerVariable } from './OpenApiServerVariable';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#serverObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#server-object
  */
 export interface OpenApiServer {
     url: string;
diff --git a/src/openApi/v3/interfaces/OpenApiServerVariable.ts b/src/openApi/v3/interfaces/OpenApiServerVariable.ts
index 6e42c1e33..68658fc01 100644
--- a/src/openApi/v3/interfaces/OpenApiServerVariable.ts
+++ b/src/openApi/v3/interfaces/OpenApiServerVariable.ts
@@ -1,7 +1,7 @@
 import type { WithEnumExtension } from '../../../types/client';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#serverVariableObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#server-variable-object
  */
 export interface OpenApiServerVariable extends WithEnumExtension {
     enum?: (string | number)[];
diff --git a/src/openApi/v3/interfaces/OpenApiTag.ts b/src/openApi/v3/interfaces/OpenApiTag.ts
index 4bded3373..9fcbec06f 100644
--- a/src/openApi/v3/interfaces/OpenApiTag.ts
+++ b/src/openApi/v3/interfaces/OpenApiTag.ts
@@ -1,7 +1,7 @@
 import type { OpenApiExternalDocs } from './OpenApiExternalDocs';
 
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#tagObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#tag-object
  */
 export interface OpenApiTag {
     name: string;
diff --git a/src/openApi/v3/interfaces/OpenApiXml.ts b/src/openApi/v3/interfaces/OpenApiXml.ts
index 2528bbd4a..4fd001eeb 100644
--- a/src/openApi/v3/interfaces/OpenApiXml.ts
+++ b/src/openApi/v3/interfaces/OpenApiXml.ts
@@ -1,5 +1,5 @@
 /**
- * https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#xmlObject
+ * {@link} https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#xml-object
  */
 export interface OpenApiXml {
     name?: string;