From a6e203b28efd5fdc0c27c04f4040f9cbe39162d2 Mon Sep 17 00:00:00 2001
From: Michael Quigley <michael@quigley.com>
Date: Tue, 20 Sep 2022 13:51:54 -0400
Subject: [PATCH] better spec organization (#50)

---
 specs/zrok.yml | 110 +++++++++++++++++++++++++------------------------
 1 file changed, 57 insertions(+), 53 deletions(-)

diff --git a/specs/zrok.yml b/specs/zrok.yml
index 8df6e4fb..1c146a99 100644
--- a/specs/zrok.yml
+++ b/specs/zrok.yml
@@ -12,9 +12,9 @@ securityDefinitions:
     name: x-token
 
 paths:
-#
-# identity
-#
+  #
+  # identity
+  #
   /account:
     post:
       tags:
@@ -105,23 +105,6 @@ paths:
         401:
           description: invalid login
 
-  /overview:
-    get:
-      tags:
-        - metadata
-      security:
-        - key: []
-      operationId: overview
-      responses:
-        200:
-          description: overview returned
-          schema:
-            $ref: "#/definitions/environmentServicesList"
-        500:
-          description: internal server error
-          schema:
-            $ref: "#/definitions/errorMessage"
-
   /register:
     post:
       tags:
@@ -142,6 +125,60 @@ paths:
           schema:
             $ref: "#/definitions/errorMessage"
 
+  /verify:
+    post:
+      tags:
+        - identity
+      operationId: verify
+      parameters:
+        - name: body
+          in: body
+          schema:
+            $ref: "#/definitions/verifyRequest"
+      responses:
+        200:
+          description: token ready
+          schema:
+            $ref: "#/definitions/verifyResponse"
+        404:
+          description: token not found
+        500:
+          description: internal server error
+          schema:
+            $ref: "#/definitions/errorMessage"
+  #
+  # metadata
+  #
+  /overview:
+    get:
+      tags:
+        - metadata
+      security:
+        - key: []
+      operationId: overview
+      responses:
+        200:
+          description: overview returned
+          schema:
+            $ref: "#/definitions/environmentServicesList"
+        500:
+          description: internal server error
+          schema:
+            $ref: "#/definitions/errorMessage"
+
+  /version:
+    get:
+      tags:
+        - metadata
+      operationId: version
+      responses:
+        200:
+          description: current server version
+          schema:
+            $ref: "#/definitions/version"
+  #
+  # tunnel
+  #
   /tunnel:
     post:
       tags:
@@ -191,39 +228,6 @@ paths:
           schema:
             $ref: "#/definitions/errorMessage"
 
-  /verify:
-    post:
-      tags:
-        - identity
-      operationId: verify
-      parameters:
-        - name: body
-          in: body
-          schema:
-            $ref: "#/definitions/verifyRequest"
-      responses:
-        200:
-          description: token ready
-          schema:
-            $ref: "#/definitions/verifyResponse"
-        404:
-          description: token not found
-        500:
-          description: internal server error
-          schema:
-            $ref: "#/definitions/errorMessage"
-
-  /version:
-    get:
-      tags:
-        - metadata
-      operationId: version
-      responses:
-        200:
-          description: current server version
-          schema:
-            $ref: "#/definitions/version"
-
 definitions:
   accountRequest:
     type: object