From 63ba588e8a1eee5d45dcce2e5f54ec5f1f959d5b Mon Sep 17 00:00:00 2001
From: Mattias-Sehlstedt <60173714+Mattias-Sehlstedt@users.noreply.github.com>
Date: Tue, 19 May 2026 20:38:35 +0200
Subject: [PATCH 1/2] docs: update format of javadoc to produce a functional
link
---
.../src/main/java/io/swagger/v3/oas/models/Components.java | 4 ++--
.../java/io/swagger/v3/oas/models/ExternalDocumentation.java | 4 ++--
.../src/main/java/io/swagger/v3/oas/models/OpenAPI.java | 4 ++--
.../src/main/java/io/swagger/v3/oas/models/Operation.java | 4 ++--
.../src/main/java/io/swagger/v3/oas/models/PathItem.java | 4 ++--
.../src/main/java/io/swagger/v3/oas/models/Paths.java | 4 ++--
.../java/io/swagger/v3/oas/models/callbacks/Callback.java | 4 ++--
.../main/java/io/swagger/v3/oas/models/examples/Example.java | 4 ++--
.../main/java/io/swagger/v3/oas/models/headers/Header.java | 4 ++--
.../src/main/java/io/swagger/v3/oas/models/info/Contact.java | 4 ++--
.../src/main/java/io/swagger/v3/oas/models/info/Info.java | 4 ++--
.../src/main/java/io/swagger/v3/oas/models/info/License.java | 4 ++--
.../src/main/java/io/swagger/v3/oas/models/links/Link.java | 4 ++--
.../src/main/java/io/swagger/v3/oas/models/media/Content.java | 2 +-
.../main/java/io/swagger/v3/oas/models/media/Encoding.java | 2 +-
.../java/io/swagger/v3/oas/models/media/EncodingProperty.java | 2 +-
.../main/java/io/swagger/v3/oas/models/media/MediaType.java | 3 ++-
.../src/main/java/io/swagger/v3/oas/models/media/Schema.java | 4 ++--
.../src/main/java/io/swagger/v3/oas/models/media/XML.java | 3 ++-
.../java/io/swagger/v3/oas/models/parameters/Parameter.java | 4 ++--
.../java/io/swagger/v3/oas/models/parameters/RequestBody.java | 4 ++--
.../java/io/swagger/v3/oas/models/responses/ApiResponse.java | 4 ++--
.../java/io/swagger/v3/oas/models/responses/ApiResponses.java | 4 ++--
.../java/io/swagger/v3/oas/models/security/OAuthFlow.java | 4 ++--
.../java/io/swagger/v3/oas/models/security/OAuthFlows.java | 4 ++--
.../main/java/io/swagger/v3/oas/models/security/Scopes.java | 2 +-
.../swagger/v3/oas/models/security/SecurityRequirement.java | 4 ++--
.../io/swagger/v3/oas/models/security/SecurityScheme.java | 4 ++--
.../main/java/io/swagger/v3/oas/models/servers/Server.java | 4 ++--
.../java/io/swagger/v3/oas/models/servers/ServerVariable.java | 4 ++--
.../io/swagger/v3/oas/models/servers/ServerVariables.java | 2 +-
.../src/main/java/io/swagger/v3/oas/models/tags/Tag.java | 4 ++--
32 files changed, 59 insertions(+), 57 deletions(-)
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/Components.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/Components.java
index ad638fd310..646f0793b9 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/Components.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/Components.java
@@ -18,8 +18,8 @@
/**
* Components
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#components-object"
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.1.1/versions/3.1.1.md#components-object"
+ * @see Components (OpenAPI 3.0 specification)
+ * @see Components (OpenAPI 3.1 specification)
*/
public class Components {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/ExternalDocumentation.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/ExternalDocumentation.java
index 16517149e0..90ea64f608 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/ExternalDocumentation.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/ExternalDocumentation.java
@@ -7,8 +7,8 @@
/**
* ExternalDocumentation
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#external-documentation-object"
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.1.1/versions/3.1.1.md#external-documentation-object"
+ * @see ExternalDocumentation (OpenAPI 3.0 specification)
+ * @see ExternalDocumentation (OpenAPI 3.1 specification)
*/
public class ExternalDocumentation {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/OpenAPI.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/OpenAPI.java
index f4a06f81ec..ad7dbe4306 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/OpenAPI.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/OpenAPI.java
@@ -18,8 +18,8 @@
/**
* OpenAPI
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md"
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.1.1/versions/3.1.1.md"
+ * @see OpenAPI (OpenAPI 3.0 specification)
+ * @see OpenAPI (OpenAPI 3.1 specification)
*/
public class OpenAPI {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/Operation.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/Operation.java
index 585b9be6a5..e581aec334 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/Operation.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/Operation.java
@@ -17,8 +17,8 @@
/**
* Operation
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#operation-object"
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.1.1/versions/3.1.1.md#operation-object"
+ * @see Operation (OpenAPI 3.0 specification)
+ * @see Operation (OpenAPI 3.1 specification)
*/
public class Operation {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/PathItem.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/PathItem.java
index 35de0a6baf..4b6acf8d80 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/PathItem.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/PathItem.java
@@ -12,8 +12,8 @@
/**
* PathItem
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#path-item-object"
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.1.1/versions/3.1.1.md#path-item-object"
+ * @see PathItem (OpenAPI 3.0 specification)
+ * @see PathItem (OpenAPI 3.1 specification)
*/
public class PathItem {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/Paths.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/Paths.java
index fb49ec1cf8..1f826f6159 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/Paths.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/Paths.java
@@ -8,8 +8,8 @@
/**
* Paths
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#paths-object"
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.1.1/versions/3.1.1.md#paths-object"
+ * @see Paths (OpenAPI 3.0 specification)
+ * @see Paths (OpenAPI 3.1 specification)
*/
public class Paths extends LinkedHashMap {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/callbacks/Callback.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/callbacks/Callback.java
index a43c9bc521..92bbbd27c9 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/callbacks/Callback.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/callbacks/Callback.java
@@ -9,8 +9,8 @@
/**
* Callback
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#callback-object"
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.1.1/versions/3.1.1.md#callback-object"
+ * @see Callback (OpenAPI 3.0 specification)
+ * @see Callback (OpenAPI 3.1 specification)
*/
public class Callback extends LinkedHashMap {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/examples/Example.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/examples/Example.java
index ae6ca234c8..7a18697cc9 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/examples/Example.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/examples/Example.java
@@ -5,8 +5,8 @@
/**
* Example
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#example-object"
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.1.1/versions/3.1.1.md#example-object"
+ * @see Example (OpenAPI 3.0 specification)
+ * @see Example (OpenAPI 3.1 specification)
*/
public class Example {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/headers/Header.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/headers/Header.java
index 5fe479795c..4c93f97060 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/headers/Header.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/headers/Header.java
@@ -11,8 +11,8 @@
/**
* Header
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#header-object"
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.1.1/versions/3.1.1.md#header-object"
+ * @see Header (OpenAPI 3.0 specification)
+ * @see Header (OpenAPI 3.1 specification)
*/
public class Header {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/info/Contact.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/info/Contact.java
index f63bb0443b..0fc7e1da8f 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/info/Contact.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/info/Contact.java
@@ -7,8 +7,8 @@
/**
* Contact
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#contact-object"
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.1.1/versions/3.1.1.md#contact-object"
+ * @see Contact (OpenAPI 3.0 specification)
+ * @see Contact (OpenAPI 3.1 specification)
*/
public class Contact {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/info/Info.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/info/Info.java
index 20807d2db3..0ddcd0b5b8 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/info/Info.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/info/Info.java
@@ -5,8 +5,8 @@
import java.util.Objects;
/**
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#info-object"
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.1.1/versions/3.1.1.md#info-object"
+ * @see Info (OpenAPI 3.0 specification)
+ * @see Info (OpenAPI 3.1 specification)
*/
public class Info {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/info/License.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/info/License.java
index 296d73ee29..e5d161c257 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/info/License.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/info/License.java
@@ -7,8 +7,8 @@
/**
* License
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#license-object"
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.1.1/versions/3.1.1.md#license-object"
+ * @see License (OpenAPI 3.0 specification)
+ * @see License (OpenAPI 3.1 specification)
*/
public class License {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/links/Link.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/links/Link.java
index a51eba18f5..2fcca74cb7 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/links/Link.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/links/Link.java
@@ -10,8 +10,8 @@
/**
* Link
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#link-object"
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.1.1/versions/3.1.1.md#link-object"
+ * @see Link (OpenAPI 3.0 specification)
+ * @see Link (OpenAPI 3.1 specification)
*/
public class Link {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/Content.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/Content.java
index e3d6afc21c..27d1da669f 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/Content.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/Content.java
@@ -6,7 +6,7 @@
/**
* Content
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#content-object"
+ * @see Content (OpenAPI 3.0 specification)
*/
public class Content extends LinkedHashMap {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/Encoding.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/Encoding.java
index cb711622aa..ab561b7bbe 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/Encoding.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/Encoding.java
@@ -10,7 +10,7 @@
/**
* Encoding
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#encoding-object"
+ * @see Encoding (OpenAPI 3.0 specification)
*/
public class Encoding {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/EncodingProperty.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/EncodingProperty.java
index 9aff35368d..d30c2da217 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/EncodingProperty.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/EncodingProperty.java
@@ -10,7 +10,7 @@
/**
* EncodingProperty
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#encoding-property-object"
+ * @see EncodingProperty (OpenAPI 3.0 specification)
*/
public class EncodingProperty {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/MediaType.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/MediaType.java
index 4e0c5e9277..74f0ec8018 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/MediaType.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/MediaType.java
@@ -10,7 +10,8 @@
/**
* MediaType
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#media-type-object"
+ * @see MediaType (OpenAPI 3.0 specification)
+ * @see MediaType (OpenAPI 3.1 specification)
*/
public class MediaType {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/Schema.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/Schema.java
index 62008eb5b9..ebe344bda3 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/Schema.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/Schema.java
@@ -21,8 +21,8 @@
/**
* Schema
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#schema-object"
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.1.1/versions/3.1.1.md#schema-object"
+ * @see Schema (OpenAPI 3.0 specification)
+ * @see Schema (OpenAPI 3.1 specification)
*/
public class Schema {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/XML.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/XML.java
index dad66ff647..083e229b90 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/XML.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/XML.java
@@ -7,7 +7,8 @@
/**
* XML
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#xml-object"
+ * @see XML (OpenAPI 3.0 specification)
+ * @see XML (OpenAPI 3.1 specification)
*/
public class XML {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/parameters/Parameter.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/parameters/Parameter.java
index e58c7be715..5eaf05c28c 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/parameters/Parameter.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/parameters/Parameter.java
@@ -12,8 +12,8 @@
/**
* Parameter
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#parameter-object"
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.1.1/versions/3.1.1.md#parameter-object"
+ * @see Parameter (OpenAPI 3.0 specification)
+ * @see Parameter (OpenAPI 3.1 specification)
*/
public class Parameter {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/parameters/RequestBody.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/parameters/RequestBody.java
index 9ac0226da7..6f08602067 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/parameters/RequestBody.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/parameters/RequestBody.java
@@ -6,8 +6,8 @@
/**
* RequestBody
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#requestBody-object"
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.1.1/versions/3.1.1.md#request-body-object"
+ * @see RequestBody (OpenAPI 3.0 specification)
+ * @see RequestBody (OpenAPI 3.1 specification)
*/
public class RequestBody {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/responses/ApiResponse.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/responses/ApiResponse.java
index 7549cc9d47..af4d5d7db3 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/responses/ApiResponse.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/responses/ApiResponse.java
@@ -12,8 +12,8 @@
/**
* ApiResponse
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#response-object"
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.1.1/versions/3.1.1.md#response-object"
+ * @see ApiResponse (OpenAPI 3.0 specification)
+ * @see ApiResponse (OpenAPI 3.1 specification)
*/
public class ApiResponse {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/responses/ApiResponses.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/responses/ApiResponses.java
index fac8020792..e8861baf5f 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/responses/ApiResponses.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/responses/ApiResponses.java
@@ -8,8 +8,8 @@
/**
* ApiResponses
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#responses-object"
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.1.1/versions/3.1.1.md#responses-object"
+ * @see ApiResponses (OpenAPI 3.0 specification)
+ * @see ApiResponses (OpenAPI 3.1 specification)
*/
public class ApiResponses extends LinkedHashMap {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/security/OAuthFlow.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/security/OAuthFlow.java
index 16bbdeade3..80596ab1ed 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/security/OAuthFlow.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/security/OAuthFlow.java
@@ -7,8 +7,8 @@
/**
* OAuthFlow
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#oauth-flows-object"
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.1.1/versions/3.1.1.md#oauth-flows-object"
+ * @see OAuthFlow (OpenAPI 3.0 specification)
+ * @see OAuthFlow (OpenAPI 3.1 specification)
*/
public class OAuthFlow {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/security/OAuthFlows.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/security/OAuthFlows.java
index 31d74f5507..c2cd4a69f1 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/security/OAuthFlows.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/security/OAuthFlows.java
@@ -7,8 +7,8 @@
/**
* OAuthFlows
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#oauth-flows-object"
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.1.1/versions/3.1.1.md#oauth-flows-object"
+ * @see OAuthFlows (OpenAPI 3.0 specification)
+ * @see OAuthFlows (OpenAPI 3.1 specification)
*/
public class OAuthFlows {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/security/Scopes.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/security/Scopes.java
index 185c256826..1fe5611a7c 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/security/Scopes.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/security/Scopes.java
@@ -6,7 +6,7 @@
/**
* Scopes
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#scoped-object"
+ * @see Scopes (OpenAPI 3.0 specification)
*/
public class Scopes extends LinkedHashMap {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/security/SecurityRequirement.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/security/SecurityRequirement.java
index cd0b7e4d54..2c466c9e89 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/security/SecurityRequirement.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/security/SecurityRequirement.java
@@ -9,8 +9,8 @@
/**
* SecurityRequirement
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#security-requirement-object"
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.1.1/versions/3.1.1.md#security-requirement-object"
+ * @see SecurityRequirement (OpenAPI 3.0 specification)
+ * @see SecurityRequirement (OpenAPI 3.1 specification)
*/
public class SecurityRequirement extends LinkedHashMap> {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/security/SecurityScheme.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/security/SecurityScheme.java
index 75bb6b30d5..7ed4e0ddf9 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/security/SecurityScheme.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/security/SecurityScheme.java
@@ -5,8 +5,8 @@
/**
* SecurityScheme
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#security-scheme-object"
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.1.1/versions/3.1.1.md#security-scheme-object"
+ * @see SecurityScheme (OpenAPI 3.0 specification)
+ * @see SecurityScheme (OpenAPI 3.1 specification)
*/
public class SecurityScheme {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/servers/Server.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/servers/Server.java
index eb8be59e56..df34aeca0c 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/servers/Server.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/servers/Server.java
@@ -7,8 +7,8 @@
/**
* Server
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#server-object"
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.1.1/versions/3.1.1.md#server-object"
+ * @see Server (OpenAPI 3.0 specification)
+ * @see Server (OpenAPI 3.1 specification)
*/
public class Server {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/servers/ServerVariable.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/servers/ServerVariable.java
index 25083db03f..ab780f8ab5 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/servers/ServerVariable.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/servers/ServerVariable.java
@@ -9,8 +9,8 @@
/**
* ServerVariable
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#server-variable-object"
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.1.1/versions/3.1.1.md#server-variable-object"
+ * @see ServerVariable (OpenAPI 3.0 specification)
+ * @see ServerVariable (OpenAPI 3.1 specification)
*/
public class ServerVariable {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/servers/ServerVariables.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/servers/ServerVariables.java
index f3d4c7c6c1..967d8e1fed 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/servers/ServerVariables.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/servers/ServerVariables.java
@@ -6,7 +6,7 @@
/**
* ServerVariables
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#server-variables-object"
+ * @see ServerVariables (OpenAPI 3.0 specification)
*/
public class ServerVariables extends LinkedHashMap {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/tags/Tag.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/tags/Tag.java
index 4efe150280..ef553ac7f5 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/tags/Tag.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/tags/Tag.java
@@ -8,8 +8,8 @@
/**
* Tag
*
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.0.4/versions/3.0.4.md#tag-object"
- * @see "https://github.com/OAI/OpenAPI-Specification/blob/3.1.1/versions/3.1.1.md#tag-object"
+ * @see Tag (OpenAPI 3.0 specification)
+ * @see Tag (OpenAPI 3.1 specification)
*/
public class Tag {
From 11059c7869ad408fc3c0c6ea5947a37c92fbead1 Mon Sep 17 00:00:00 2001
From: Ewa Ostrowska
Date: Fri, 19 Jun 2026 13:31:37 +0200
Subject: [PATCH 2/2] fix: broken and incorrect documentation links
---
.../main/java/io/swagger/v3/oas/models/media/Content.java | 5 ++---
.../io/swagger/v3/oas/models/media/EncodingProperty.java | 5 ++---
.../io/swagger/v3/oas/models/parameters/RequestBody.java | 5 ++---
.../java/io/swagger/v3/oas/models/security/OAuthFlow.java | 7 +++----
.../java/io/swagger/v3/oas/models/security/Scopes.java | 5 ++---
5 files changed, 11 insertions(+), 16 deletions(-)
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/Content.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/Content.java
index 27d1da669f..3052fdf1f2 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/Content.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/Content.java
@@ -4,9 +4,8 @@
import java.util.Objects;
/**
- * Content
- *
- * @see Content (OpenAPI 3.0 specification)
+ * Content is a map of Media Type Objects
+ * @see Content (OpenAPI 3.0 specification)
*/
public class Content extends LinkedHashMap {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/EncodingProperty.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/EncodingProperty.java
index d30c2da217..e4a2ad6918 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/EncodingProperty.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/media/EncodingProperty.java
@@ -8,9 +8,8 @@
import java.util.Objects;
/**
- * EncodingProperty
- *
- * @see EncodingProperty (OpenAPI 3.0 specification)
+ * A single encoding definition applied to a single schema property.
+ * @see EncodingProperty (OpenAPI 3.0 specification)
*/
public class EncodingProperty {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/parameters/RequestBody.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/parameters/RequestBody.java
index 6f08602067..3c13f04000 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/parameters/RequestBody.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/parameters/RequestBody.java
@@ -4,9 +4,8 @@
import io.swagger.v3.oas.models.media.Content;
/**
- * RequestBody
- *
- * @see RequestBody (OpenAPI 3.0 specification)
+ * Describes a single request body.
+ * @see RequestBody (OpenAPI 3.0 specification)
* @see RequestBody (OpenAPI 3.1 specification)
*/
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/security/OAuthFlow.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/security/OAuthFlow.java
index 80596ab1ed..f1a3eabe75 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/security/OAuthFlow.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/security/OAuthFlow.java
@@ -5,10 +5,9 @@
import java.util.Objects;
/**
- * OAuthFlow
- *
- * @see OAuthFlow (OpenAPI 3.0 specification)
- * @see OAuthFlow (OpenAPI 3.1 specification)
+ * Configuration details for a supported OAuth Flow.
+ * @see OAuthFlow (OpenAPI 3.0 specification)
+ * @see OAuthFlow (OpenAPI 3.1 specification)
*/
public class OAuthFlow {
diff --git a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/security/Scopes.java b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/security/Scopes.java
index 1fe5611a7c..a6cfdb491e 100644
--- a/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/security/Scopes.java
+++ b/modules/swagger-models/src/main/java/io/swagger/v3/oas/models/security/Scopes.java
@@ -4,9 +4,8 @@
import java.util.Objects;
/**
- * Scopes
- *
- * @see Scopes (OpenAPI 3.0 specification)
+ * The available scopes for an OAuth Flow, as a map of scope name to short description.
+ * @see Scopes (OpenAPI 3.0 specification)
*/
public class Scopes extends LinkedHashMap {