add openapi-linter and rename openapi-example

add global tags to openapi example

Author: pdowler

openapi-linter

@@ -0,0 +1,8 @@
+#!/bin/bash
+
+if [[ "$1" == "-it" ]]; then
+  docker run -it --rm -v $PWD:/work:ro dshanley/vacuum /bin/bash
+else
+  docker run --rm -v $PWD:/work:ro dshanley/vacuum lint --no-clip -d openapi.yaml
+fi
+

openapi-example.yaml openapi.yamlopenapi-example.yaml renamed to openapi.yaml

@@ -5,15 +5,20 @@ info:
   description: This is an example of using VOSI-1.2 components.
 servers:
 - url: /example
+
+tags:
+    - name: VOSI Capabilities
+    - name: VOSI Table Metadata
+
 paths:
 # notes: this is how another service like TAP would include VOSI endpoints using 
 # a local copy; the commented out $ref to a standard location would also work
     /tables:
-        $ref: ./vosi-tableset.yaml
+        $ref: ./openapi/vosi/vosi-tableset.yaml
         #$ref: https://ivoa.net/std/VOSI/vosi-tableset.yaml
     /tables/{name}:
-        $ref: ./vosi-table.yaml
+        $ref: ./openapi/vosi/vosi-table.yaml
         #$ref: https://ivoa.net/std/VOSI/vosi-table.yaml
     /capabilities:
-        $ref: ./paths/vosi-capabilities.yaml
+        $ref: ./openapi/vosi/vosi-capabilities.yaml
         #$ref: https://ivoa.net/std/VOSI/vosi-capabilities.yaml