[strimzi#434] docs: edits after review & changelog

Signed-off-by: ilkerkocatepe <[email protected]>

Author: ilkerkocatepe

CHANGELOG.md

@@ -3,6 +3,7 @@
 ## 0.31.0
 
 * Dependency updates (Vert.x 4.5.10)
+* Added support for creating a new topic via endpoint.
 
 ## 0.30.0
 

documentation/book/api/.openapi-generator/openapi.json-generate-apidoc.sha256

@@ -1 +1 @@
-444170efeb26c6a819d27e54c5571469b44678895d9090c6c09d0de6318bcf6d
+cf88d8909114896517ba4027596382126bca594d55dd9a924330232407e603b2

documentation/book/api/index.adoc

@@ -2298,7 +2298,7 @@ endif::internal-generation[]
 
 ===== Description
 
-Creates a topic with given name, partitions count and replication factor.
+Creates a topic with given name, partitions count, and replication factor.
 
 
 // markup not found, no include::{specDir}admin/topics/POST/spec.adoc[opts=optional]
@@ -2315,7 +2315,7 @@ Creates a topic with given name, partitions count and replication factor.
 |Name| Description| Required| Default| Pattern
 
 | NewTopic
-| Creates a topic with given name, partitions count and replication factor. <<NewTopic>>
+| Creates a topic with given name, partitions count, and replication factor. <<NewTopic>>
 | X
 | 
 | 
@@ -2333,9 +2333,6 @@ Creates a topic with given name, partitions count and replication factor.
 
 -
 
-===== Content Type
-
-* application/vnd.kafka.v2+json
 
 ===== Responses
 

src/main/java/io/strimzi/kafka/bridge/http/HttpAdminBridgeEndpoint.java

@@ -180,7 +180,7 @@ public void doGetTopic(RoutingContext routingContext) {
     }
 
     /**
-     * Create a topic with described name, partitions count and replication factor in the body of the HTTP request
+     * Create a topic with described name, partitions count, and replication factor in the body of the HTTP request
      *
      * @param routingContext the routing context
      */

src/main/resources/openapi.json

@@ -758,10 +758,10 @@
                 "tags": [
                     "Topics"
                 ],
-                "description": "Creates a topic with given name, partitions count and replication factor.",
+                "description": "Creates a topic with given name, partitions count, and replication factor.",
                 "operationId": "createTopic",
                 "requestBody": {
-                    "description": "Creates a topic with given name, partitions count and replication factor.",
+                    "description": "Creates a topic with given name, partitions count, and replication factor.",
                     "content": {
                         "application/vnd.kafka.json.v2+json": {
                             "schema": {
@@ -773,10 +773,7 @@
                 },
                 "responses": {
                     "201": {
-                        "description": "Created",
-                        "content": {
-                            "application/vnd.kafka.v2+json": {}
-                        }
+                        "description": "Created"
                     }
                 }
             }

src/main/resources/openapiv2.json

@@ -691,7 +691,7 @@
         "tags": [
           "Topics"
         ],
-        "description": "Creates a topic with given name, partitions count and replication factor.",
+        "description": "Creates a topic with given name, partitions count, and replication factor.",
         "operationId": "createTopic",
         "consumes": [
           "application/vnd.kafka.v2+json"
@@ -711,8 +711,7 @@
         ],
         "responses": {
           "201": {
-            "description": "Created",
-            "schema": {}
+            "description": "Created"
           }
         }
       }