adding text to changelog and refactoring code from chapters to prologue

Signed-off-by: Niyazbek Torekeldi <[email protected]>

CHANGELOG.md

@@ -35,6 +35,7 @@ Inspired from [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 - Added AjvErrorsParser to print more informative error messages ([#364](https://github.com/opensearch-project/opensearch-api-specification/issues/364))
 - Added JsonSchemaValidator, a wrapper for AJV ([#364](https://github.com/opensearch-project/opensearch-api-specification/issues/364))
 - Added support for `application/cbor` responses ([#371](https://github.com/opensearch-project/opensearch-api-specification/pull/371))
+- Added `/_plugins/_sql`, `close`, `explain` and `stats` ([#379](https://github.com/opensearch-project/opensearch-api-specification/pull/379))
 - Added tests for SQL namespace ([#379](https://github.com/opensearch-project/opensearch-api-specification/pull/379))
 - Added support for `application/smile` responses ([#386](https://github.com/opensearch-project/opensearch-api-specification/pull/386))
 - Added `doc_status`, `remote_store`, `segment_replication` and `unreferenced_file_cleanups_performed` to `SegmentStats` ([#395](https://github.com/opensearch-project/opensearch-api-specification/pull/395))

tests/sql/close.yaml

@@ -9,13 +9,7 @@ prologues:
       index: books
     request_body:
       payload: {}
-epilogues:
-  - path: /books
-    method: DELETE
-    status: [200, 404]
-chapters:
-  - synopsis: Create few documents.
-    path: /_bulk
+  - path: /_bulk
     method: POST
     request_body:
       content_type: application/x-ndjson
@@ -24,13 +18,15 @@ chapters:
         - {author: Harper Lee, title: To Kill a Mockingbird, year: 1960}
         - {create: {_index: books, _id: book_1392215}}
         - {author: Elizabeth Rudnick, title: Beauty and the Beast, year: 1991}
-  - synopsis: Refresh the index.
-    path: /{index}/_refresh
+  - path: /{index}/_refresh
     method: POST
     parameters:
       index: books
-    response:
-      status: 200
+epilogues:
+  - path: /books
+    method: DELETE
+    status: [200, 404]
+chapters:
   - synopsis: Get SQL query.
     id: query_sql
     path: /_plugins/_sql
@@ -43,7 +39,7 @@ chapters:
       status: 200
     output:
       cursor: payload.cursor
-  - synopsis: Close cursor
+  - synopsis: Close cursor.
     path: /_plugins/_sql/close
     method: POST
     request_body: