WIP

mtojek · mtojek · commit 484f1e901ff4 · 2022-12-09T16:08:13.000+01:00
diff --git a/Makefile b/Makefile
@@ -401,7 +401,7 @@ gen: \
 	provisionerd/proto/provisionerd.pb.go \
 	site/src/api/typesGenerated.ts \
 	docs/admin/prometheus.md \
-	$(wildcard coderd/apidocgen/*)
+	coderd/apidocs $(wildcard coderd/apidocgen/*)
 .PHONY: gen
 
 # Mark all generated files as fresh so make thinks they're up-to-date. This is
diff --git a/coderd/apidocs/docs.go b/coderd/apidocs/docs.go
@@ -10,7 +10,16 @@ const docTemplate = `{
     "info": {
         "description": "{{escape .Description}}",
         "title": "{{.Title}}",
-        "contact": {},
+        "termsOfService": "https://coder.com/legal/terms-of-service",
+        "contact": {
+            "name": "API Support",
+            "url": "http://coder.com",
+            "email": "support@coder.com"
+        },
+        "license": {
+            "name": "AGPL-3.0",
+            "url": "https://github.com/coder/coder/blob/main/LICENSE"
+        },
         "version": "{{.Version}}"
     },
     "host": "{{.Host}}",
@@ -20,12 +29,12 @@ const docTemplate = `{
 
 // SwaggerInfo holds exported Swagger Info so clients can modify it
 var SwaggerInfo = &swag.Spec{
-	Version:          "",
-	Host:             "",
-	BasePath:         "",
+	Version:          "1.0",
+	Host:             "dev.coder.com",
+	BasePath:         "/v2",
 	Schemes:          []string{},
-	Title:            "",
-	Description:      "",
+	Title:            "Coder API",
+	Description:      "Coderd API",
 	InfoInstanceName: "swagger",
 	SwaggerTemplate:  docTemplate,
 }
diff --git a/coderd/apidocs/swagger.json b/coderd/apidocs/swagger.json
@@ -1,7 +1,21 @@
 {
     "swagger": "2.0",
     "info": {
-        "contact": {}
+        "description": "Coderd API",
+        "title": "Coder API",
+        "termsOfService": "https://coder.com/legal/terms-of-service",
+        "contact": {
+            "name": "API Support",
+            "url": "http://coder.com",
+            "email": "support@coder.com"
+        },
+        "license": {
+            "name": "AGPL-3.0",
+            "url": "https://github.com/coder/coder/blob/main/LICENSE"
+        },
+        "version": "1.0"
     },
+    "host": "dev.coder.com",
+    "basePath": "/v2",
     "paths": {}
 }
