From a90d26bd24d2adcc3559c8bc45124b4acc60f95d Mon Sep 17 00:00:00 2001
From: Pavel Bodiachevskii <pavelbodyachevskiy@gmail.com>
Date: Thu, 2 May 2024 01:14:17 +0400
Subject: [PATCH] build: fix javadocs

https://github.com/asyncapi/jasyncapi/issues/184
---
 .../model/schema/SchemasAdditionalPropertiesDeserializer.java | 2 ++
 .../model/schema/SchemasAdditionalPropertiesDeserializer.java | 2 ++
 asyncapi-core/src/main/java/com/asyncapi/v2/schema/Type.java  | 2 ++
 .../com/asyncapi/v2/security_scheme/ApiKeySecurityScheme.java | 2 ++
 .../v2/security_scheme/OpenIdConnectSecurityScheme.java       | 2 ++
 .../v2/security_scheme/http/HttpApiKeySecurityScheme.java     | 2 ++
 .../asyncapi/v2/security_scheme/http/HttpSecurityScheme.java  | 2 ++
 .../v2/security_scheme/oauth2/OAuth2SecurityScheme.java       | 2 ++
 .../oauth2/flow/ClientCredentialsOAuthFlow.java               | 4 ++++
 .../v2/security_scheme/oauth2/flow/ImplicitOAuthFlow.java     | 4 ++++
 .../v2/security_scheme/oauth2/flow/PasswordOAuthFlow.java     | 4 ++++
 .../AsyncAPISchemaAdditionalPropertiesDeserializer.java       | 2 ++
 .../v3/jackson/schema/AsyncAPISchemaAnyValueDeserializer.java | 2 ++
 .../v3/jackson/schema/AsyncAPISchemaItemsDeserializer.java    | 3 +++
 .../v3/jackson/schema/JsonSchemaAnyValueDeserializer.java     | 2 ++
 .../v3/jackson/schema/JsonSchemaItemsDeserializer.java        | 3 +++
 .../v3/jackson/schema/JsonSchemaPropertiesDeserializer.java   | 2 ++
 .../v3/jackson/schema/SchemaAnyValueDeserializer.java         | 3 +++
 .../OpenAPISchemaAdditionalPropertiesDeserializer.java        | 2 ++
 .../schema/openapi/OpenAPISchemaAnyValueDeserializer.java     | 2 ++
 asyncapi-core/src/main/java/com/asyncapi/v3/schema/Type.java  | 2 ++
 .../com/asyncapi/v3/schema/avro/v1/_9_0/AvroSchemaArray.java  | 2 ++
 .../com/asyncapi/v3/schema/avro/v1/_9_0/AvroSchemaFixed.java  | 2 ++
 .../v3/schema/avro/v1/_9_0/AvroSchemaLogicalType.java         | 3 +++
 .../com/asyncapi/v3/schema/avro/v1/_9_0/AvroSchemaMap.java    | 2 ++
 .../asyncapi/v3/schema/avro/v1/_9_0/AvroSchemaMetadata.java   | 3 +++
 .../com/asyncapi/v3/schema/multiformat/MultiFormatSchema.java | 1 +
 .../com/asyncapi/v3/schema/openapi/v3/_0_0/OpenAPISchema.java | 4 ++--
 .../v3/schema/openapi/v3/_0_0/properties/Extensions.java      | 2 ++
 29 files changed, 68 insertions(+), 2 deletions(-)

diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/schema/SchemasAdditionalPropertiesDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/schema/SchemasAdditionalPropertiesDeserializer.java
index a02e585e..59ca2650 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/schema/SchemasAdditionalPropertiesDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/schema/SchemasAdditionalPropertiesDeserializer.java
@@ -11,6 +11,8 @@
 import java.io.IOException;
 
 /**
+ * Deserialize Schema additional properties
+ *
  * @author Guillaume LAMIRAND (guillaume.lamirand at graviteesource.com)
  * @author GraviteeSource Team
  */
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/schema/SchemasAdditionalPropertiesDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/schema/SchemasAdditionalPropertiesDeserializer.java
index 8cc6e9ec..0f1cce06 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/schema/SchemasAdditionalPropertiesDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/schema/SchemasAdditionalPropertiesDeserializer.java
@@ -11,6 +11,8 @@
 import java.io.IOException;
 
 /**
+ * Deserialize Schema additional properties
+ *
  * @author Guillaume LAMIRAND (guillaume.lamirand at graviteesource.com)
  * @author GraviteeSource Team
  */
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/schema/Type.java b/asyncapi-core/src/main/java/com/asyncapi/v2/schema/Type.java
index 1a0572aa..8b417e62 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/schema/Type.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/schema/Type.java
@@ -1,6 +1,8 @@
 package com.asyncapi.v2.schema;
 
 /**
+ * Json Schema type.
+ *
  * @author Pavel Bodiachevskii
  */
 public class Type {
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/ApiKeySecurityScheme.java b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/ApiKeySecurityScheme.java
index f9dd75d4..81c899ba 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/ApiKeySecurityScheme.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/ApiKeySecurityScheme.java
@@ -10,6 +10,8 @@
 import org.jetbrains.annotations.Nullable;
 
 /**
+ * API Key Security Scheme
+ *
  * @version 2.6.0
  * @see <a href="https://www.asyncapi.com/docs/reference/specification/v2.6.0#securitySchemeObject">SecurityScheme</a>
  * @author Pavel Bodiachevskii
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/OpenIdConnectSecurityScheme.java b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/OpenIdConnectSecurityScheme.java
index e1e52549..561e58d2 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/OpenIdConnectSecurityScheme.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/OpenIdConnectSecurityScheme.java
@@ -9,6 +9,8 @@
 import org.jetbrains.annotations.Nullable;
 
 /**
+ * OpenID Connect Security Scheme
+ *
  * @version 2.6.0
  * @see <a href="https://www.asyncapi.com/docs/reference/specification/v2.6.0#securitySchemeObject">SecurityScheme</a>
  * @author Pavel Bodiachevskii
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/http/HttpApiKeySecurityScheme.java b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/http/HttpApiKeySecurityScheme.java
index 13786bae..9d8e0f12 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/http/HttpApiKeySecurityScheme.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/http/HttpApiKeySecurityScheme.java
@@ -11,6 +11,8 @@
 import org.jetbrains.annotations.Nullable;
 
 /**
+ * HTTP API Key Security Scheme
+ *
  * @version 2.6.0
  * @see <a href="https://www.asyncapi.com/docs/reference/specification/v2.6.0#securitySchemeObject">SecurityScheme</a>
  * @author Pavel Bodiachevskii
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/http/HttpSecurityScheme.java b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/http/HttpSecurityScheme.java
index 63b77d0a..e6178101 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/http/HttpSecurityScheme.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/http/HttpSecurityScheme.java
@@ -10,6 +10,8 @@
 import org.jetbrains.annotations.Nullable;
 
 /**
+ * HTTP Security Scheme
+ *
  * @version 2.6.0
  * @see <a href="https://www.asyncapi.com/docs/reference/specification/v2.6.0#securitySchemeObject">SecurityScheme</a>
  * @author Pavel Bodiachevskii
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/OAuth2SecurityScheme.java b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/OAuth2SecurityScheme.java
index 7bb2b660..c8a009c8 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/OAuth2SecurityScheme.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/OAuth2SecurityScheme.java
@@ -10,6 +10,8 @@
 import org.jetbrains.annotations.Nullable;
 
 /**
+ * OAuth2 Security Scheme
+ *
  * @version 2.6.0
  * @see <a href="https://www.asyncapi.com/docs/reference/specification/v2.6.0#securitySchemeObject">SecurityScheme</a>
  * @author Pavel Bodiachevskii
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/ClientCredentialsOAuthFlow.java b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/ClientCredentialsOAuthFlow.java
index 15e05e07..0d538bf3 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/ClientCredentialsOAuthFlow.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/ClientCredentialsOAuthFlow.java
@@ -11,6 +11,10 @@
 import java.util.Map;
 
 /**
+ * Configuration for the OAuth Client Credentials flow
+ * <p>
+ * This object MAY be extended with {@link com.asyncapi.ExtendableObject}.
+ *
  * @version 2.6.0
  * @see <a href="https://www.asyncapi.com/docs/reference/specification/v2.6.0#oauthFlowObject">OAuth Flow Object</a>
  * @author Pavel Bodiachevskii
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/ImplicitOAuthFlow.java b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/ImplicitOAuthFlow.java
index 6518da51..4d88aa52 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/ImplicitOAuthFlow.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/ImplicitOAuthFlow.java
@@ -11,6 +11,10 @@
 import java.util.Map;
 
 /**
+ * Configuration for the OAuth Implicit flow
+ * <p>
+ * This object MAY be extended with {@link com.asyncapi.ExtendableObject}.
+ *
  * @version 2.6.0
  * @see <a href="https://www.asyncapi.com/docs/reference/specification/v2.6.0#oauthFlowObject">OAuth Flow Object</a>
  * @author Pavel Bodiachevskii
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/PasswordOAuthFlow.java b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/PasswordOAuthFlow.java
index 693d219c..54345b50 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/PasswordOAuthFlow.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/PasswordOAuthFlow.java
@@ -11,6 +11,10 @@
 import java.util.Map;
 
 /**
+ * Configuration for the OAuth Resource Owner Protected Credentials flow
+ * <p>
+ * This object MAY be extended with {@link com.asyncapi.ExtendableObject}.
+ *
  * @version 2.6.0
  * @see <a href="https://www.asyncapi.com/docs/reference/specification/v2.6.0#oauthFlowObject">OAuth Flow Object</a>
  * @author Pavel Bodiachevskii
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/AsyncAPISchemaAdditionalPropertiesDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/AsyncAPISchemaAdditionalPropertiesDeserializer.java
index 0e751265..87e2e636 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/AsyncAPISchemaAdditionalPropertiesDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/AsyncAPISchemaAdditionalPropertiesDeserializer.java
@@ -11,6 +11,8 @@
 import java.io.IOException;
 
 /**
+ * AsyncAPI Schema additional properties deserializer
+ *
  * @author Guillaume LAMIRAND (guillaume.lamirand at graviteesource.com)
  * @author GraviteeSource Team
  */
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/AsyncAPISchemaAnyValueDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/AsyncAPISchemaAnyValueDeserializer.java
index 6934993a..d64884d0 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/AsyncAPISchemaAnyValueDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/AsyncAPISchemaAnyValueDeserializer.java
@@ -3,6 +3,8 @@
 import com.asyncapi.v3.schema.AsyncAPISchema;
 
 /**
+ * AsyncAPI Schema any value deserializer
+ *
  * @author Pavel Bodiachevskii
  */
 public class AsyncAPISchemaAnyValueDeserializer extends SchemaAnyValueDeserializer<AsyncAPISchema> {
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/AsyncAPISchemaItemsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/AsyncAPISchemaItemsDeserializer.java
index 8b1f4fcd..2bad7eb6 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/AsyncAPISchemaItemsDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/AsyncAPISchemaItemsDeserializer.java
@@ -14,6 +14,9 @@
 import java.util.ArrayList;
 import java.util.List;
 
+/**
+ * AsyncAPI Schema items deserializer
+ */
 public class AsyncAPISchemaItemsDeserializer extends SchemaItemsDeserializer<AsyncAPISchema> {
 
     public Class<AsyncAPISchema> schemaClass() {
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/JsonSchemaAnyValueDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/JsonSchemaAnyValueDeserializer.java
index cd25811b..bc0d5e48 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/JsonSchemaAnyValueDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/JsonSchemaAnyValueDeserializer.java
@@ -3,6 +3,8 @@
 import com.asyncapi.v3.schema.JsonSchema;
 
 /**
+ * Json Schema any value deserializer
+ *
  * @author Pavel Bodiachevskii
  */
 public class JsonSchemaAnyValueDeserializer extends SchemaAnyValueDeserializer<JsonSchema> {
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/JsonSchemaItemsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/JsonSchemaItemsDeserializer.java
index bd097e7c..2ec9c9f5 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/JsonSchemaItemsDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/JsonSchemaItemsDeserializer.java
@@ -3,6 +3,9 @@
 import com.asyncapi.v3.jackson.SchemaItemsDeserializer;
 import com.asyncapi.v3.schema.JsonSchema;
 
+/**
+ * Json Schema items deserializer
+ */
 public class JsonSchemaItemsDeserializer extends SchemaItemsDeserializer<JsonSchema> {
 
     public Class<JsonSchema> schemaClass() {
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/JsonSchemaPropertiesDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/JsonSchemaPropertiesDeserializer.java
index 71402943..73830158 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/JsonSchemaPropertiesDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/JsonSchemaPropertiesDeserializer.java
@@ -11,6 +11,8 @@
 import java.io.IOException;
 
 /**
+ * Json Schema properties deserializer.
+ *
  * @author Guillaume LAMIRAND (guillaume.lamirand at graviteesource.com)
  * @author GraviteeSource Team
  */
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/SchemaAnyValueDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/SchemaAnyValueDeserializer.java
index 09ca14d0..8cb91a10 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/SchemaAnyValueDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/SchemaAnyValueDeserializer.java
@@ -14,6 +14,9 @@
 import java.util.List;
 
 /**
+ * Abstract Schema any value deserializer
+ *
+ * @param <Schema> schema to deserialize
  * @author Pavel Bodiachevskii
  */
 public abstract class SchemaAnyValueDeserializer<Schema> extends JsonDeserializer<Object> {
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/openapi/OpenAPISchemaAdditionalPropertiesDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/openapi/OpenAPISchemaAdditionalPropertiesDeserializer.java
index faa5c83b..34828aad 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/openapi/OpenAPISchemaAdditionalPropertiesDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/openapi/OpenAPISchemaAdditionalPropertiesDeserializer.java
@@ -11,6 +11,8 @@
 import java.io.IOException;
 
 /**
+ * OpenAPI Schema additional properties deserializer
+ *
  * @author Pavel Bodiachevskii
  * @version 3.0.0
  */
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/openapi/OpenAPISchemaAnyValueDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/openapi/OpenAPISchemaAnyValueDeserializer.java
index 1dd7a133..1d09695f 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/openapi/OpenAPISchemaAnyValueDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/openapi/OpenAPISchemaAnyValueDeserializer.java
@@ -4,6 +4,8 @@
 import com.asyncapi.v3.schema.openapi.v3._0_0.OpenAPISchema;
 
 /**
+ * OpenAPI Schema any value deserializer
+ *
  * @author Pavel Bodiachevskii
  */
 public class OpenAPISchemaAnyValueDeserializer extends SchemaAnyValueDeserializer<OpenAPISchema> {
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/schema/Type.java b/asyncapi-core/src/main/java/com/asyncapi/v3/schema/Type.java
index 957e6b30..653130e5 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v3/schema/Type.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/schema/Type.java
@@ -1,6 +1,8 @@
 package com.asyncapi.v3.schema;
 
 /**
+ * Json Schema type.
+ *
  * @author Pavel Bodiachevskii
  */
 public class Type {
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/schema/avro/v1/_9_0/AvroSchemaArray.java b/asyncapi-core/src/main/java/com/asyncapi/v3/schema/avro/v1/_9_0/AvroSchemaArray.java
index a51a1c4e..7adbf8c1 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v3/schema/avro/v1/_9_0/AvroSchemaArray.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/schema/avro/v1/_9_0/AvroSchemaArray.java
@@ -13,6 +13,8 @@
 import java.util.Map;
 
 /**
+ * Avro Array Schema
+ *
  * @see <a href="https://avro.apache.org/docs/1.9.0/spec.html#Arrays">Arrays</a>
  */
 @Data
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/schema/avro/v1/_9_0/AvroSchemaFixed.java b/asyncapi-core/src/main/java/com/asyncapi/v3/schema/avro/v1/_9_0/AvroSchemaFixed.java
index 18e8abc9..3ab8ba2c 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v3/schema/avro/v1/_9_0/AvroSchemaFixed.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/schema/avro/v1/_9_0/AvroSchemaFixed.java
@@ -10,6 +10,8 @@
 import java.util.Map;
 
 /**
+ * Avro Fixed Schema
+ *
  * @see <a href="https://avro.apache.org/docs/1.9.0/spec.html#Arrays">Arrays</a>
  */
 @Data
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/schema/avro/v1/_9_0/AvroSchemaLogicalType.java b/asyncapi-core/src/main/java/com/asyncapi/v3/schema/avro/v1/_9_0/AvroSchemaLogicalType.java
index 98f4dd8f..78b72fcd 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v3/schema/avro/v1/_9_0/AvroSchemaLogicalType.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/schema/avro/v1/_9_0/AvroSchemaLogicalType.java
@@ -2,6 +2,9 @@
 
 import com.fasterxml.jackson.annotation.JsonProperty;
 
+/**
+ * Avro Schema logical types
+ */
 public class AvroSchemaLogicalType {
 
     @JsonProperty("decimal")
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/schema/avro/v1/_9_0/AvroSchemaMap.java b/asyncapi-core/src/main/java/com/asyncapi/v3/schema/avro/v1/_9_0/AvroSchemaMap.java
index 1ab2667f..80d1c363 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v3/schema/avro/v1/_9_0/AvroSchemaMap.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/schema/avro/v1/_9_0/AvroSchemaMap.java
@@ -12,6 +12,8 @@
 import java.util.Map;
 
 /**
+ * Avro Map Schema
+ *
  * @see <a href="https://avro.apache.org/docs/1.9.0/spec.html#Maps">Maps</a>
  */
 @Data
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/schema/avro/v1/_9_0/AvroSchemaMetadata.java b/asyncapi-core/src/main/java/com/asyncapi/v3/schema/avro/v1/_9_0/AvroSchemaMetadata.java
index 0299cf7c..52585f11 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v3/schema/avro/v1/_9_0/AvroSchemaMetadata.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/schema/avro/v1/_9_0/AvroSchemaMetadata.java
@@ -9,6 +9,9 @@
 import java.util.HashMap;
 import java.util.Map;
 
+/**
+ * Avro Schema metadata
+ */
 @Data
 @JsonIgnoreProperties({"metadata"})
 public class AvroSchemaMetadata {
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/schema/multiformat/MultiFormatSchema.java b/asyncapi-core/src/main/java/com/asyncapi/v3/schema/multiformat/MultiFormatSchema.java
index dd5720ca..801f9c2b 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v3/schema/multiformat/MultiFormatSchema.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/schema/multiformat/MultiFormatSchema.java
@@ -14,6 +14,7 @@
  * The Multi Format Schema Object represents a schema definition. It differs from the {@link AsyncAPISchema} in that it supports
  * multiple schema formats or languages (e.g., JSON Schema, Avro, etc.).
  *
+ * @param <Schema> schema to use
  * @see <a href="https://www.asyncapi.com/docs/reference/specification/v3.0.0#multiFormatSchemaObject">Multi Format Schema</a>
  * @see <a href="https://www.asyncapi.com/docs/reference/specification/v3.0.0#schemaObject">Schema</a>
  * @author Pavel Bodiachevskii
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/schema/openapi/v3/_0_0/OpenAPISchema.java b/asyncapi-core/src/main/java/com/asyncapi/v3/schema/openapi/v3/_0_0/OpenAPISchema.java
index 97f365d3..5f3af15a 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v3/schema/openapi/v3/_0_0/OpenAPISchema.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/schema/openapi/v3/_0_0/OpenAPISchema.java
@@ -109,7 +109,7 @@ public class OpenAPISchema extends Extensions {
 
     /**
      * The word “exclusive” in {@link #exclusiveMinimum} and {@link #exclusiveMaximum} means the corresponding boundary is excluded:
-     * <table summary="exclusive description">
+     * <table caption="exclusive description">
      *     <tr>
      *         <th>Keyword</th>
      *         <th>Description</th>
@@ -166,7 +166,7 @@ public class OpenAPISchema extends Extensions {
 
     /**
      * The word “exclusive” in {@link #exclusiveMinimum} and {@link #exclusiveMaximum} means the corresponding boundary is excluded:
-     * <table summary="exclusive description">
+     * <table caption="exclusive description">
      *     <tr>
      *         <th>Keyword</th>
      *         <th>Description</th>
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/schema/openapi/v3/_0_0/properties/Extensions.java b/asyncapi-core/src/main/java/com/asyncapi/v3/schema/openapi/v3/_0_0/properties/Extensions.java
index b243003f..02eaee88 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v3/schema/openapi/v3/_0_0/properties/Extensions.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/schema/openapi/v3/_0_0/properties/Extensions.java
@@ -13,6 +13,8 @@
 import java.util.regex.Pattern;
 
 /**
+ * Allows to extend AsyncAPI specification
+ *
  * @see <a href="https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.0.md#specification-extensions">Specification Extensions</a>
  */
 @Data