add comments to tap-async

ivoa-std · Nov 14, 2024 · 0cc0c35 · 0cc0c35
1 parent 81ea9d7
commit 0cc0c35
Showing 1 changed file with 3 additions and 0 deletions.
diff --git a/openapi/tap-async.yaml b/openapi/tap-async.yaml
@@ -2,6 +2,7 @@ get:
     summary: UWS 1.1
     description: async job listing
     parameters:
+        # UWS job listing control specified here
     responses:
         200:
             $ref: ./include/UWS/uws-responses.yaml#/job-listing
@@ -13,6 +14,7 @@ post:
     summary: TAP-async 1.1
     description: TAP asynchronous query endpoint (create UWS Job)
     parameters:
+        # TAP job definition specified here
       - $ref: ./parameters/tap-lang.yaml
       - $ref: ./parameters/tap-query.yaml
       - $ref: ./parameters/tap-upload.yaml
@@ -21,6 +23,7 @@ post:
       - $ref: ./parameters/dali-responseformat.yaml
     responses:
         303:
+            # UWS respoonse code
             $ref: ./include/UWS/uws-responses.yaml#/created
         401:
             $ref: ./include/VOSI/std-responses.yaml#/not-authenticated