WIP

mtojek · mtojek · commit 9a2493bd395c · 2022-12-09T16:13:00.000+01:00
diff --git a/coderd/apidocs/docs.go b/coderd/apidocs/docs.go
@@ -29,12 +29,12 @@ const docTemplate = `{
 
 // SwaggerInfo holds exported Swagger Info so clients can modify it
 var SwaggerInfo = &swag.Spec{
-	Version:          "1.0",
-	Host:             "dev.coder.com",
-	BasePath:         "/v2",
+	Version:          "2.0",
+	Host:             "",
+	BasePath:         "",
 	Schemes:          []string{},
-	Title:            "Coder API",
-	Description:      "Coderd API",
+	Title:            "Coderd API",
+	Description:      "Coderd is the service created by running coder server. It is a thin API that connects workspaces, provisioners and users. coderd stores its state in Postgres and is the only service that communicates with Postgres.",
 	InfoInstanceName: "swagger",
 	SwaggerTemplate:  docTemplate,
 }
diff --git a/coderd/apidocs/swagger.json b/coderd/apidocs/swagger.json
@@ -1,8 +1,8 @@
 {
     "swagger": "2.0",
     "info": {
-        "description": "Coderd API",
-        "title": "Coder API",
+        "description": "Coderd is the service created by running coder server. It is a thin API that connects workspaces, provisioners and users. coderd stores its state in Postgres and is the only service that communicates with Postgres.",
+        "title": "Coderd API",
         "termsOfService": "https://coder.com/legal/terms-of-service",
         "contact": {
             "name": "API Support",
@@ -13,9 +13,7 @@
             "name": "AGPL-3.0",
             "url": "https://github.com/coder/coder/blob/main/LICENSE"
         },
-        "version": "1.0"
+        "version": "2.0"
     },
-    "host": "dev.coder.com",
-    "basePath": "/v2",
     "paths": {}
 }
diff --git a/coderd/coderd.go b/coderd/coderd.go
@@ -111,9 +111,9 @@ type Options struct {
 	UpdateCheckOptions          *updatecheck.Options // Set non-nil to enable update checking.
 }
 
-// @title Coder API
-// @version 1.0
-// @description Coderd API
+// @title Coderd API
+// @version 2.0
+// @description Coderd is the service created by running coder server. It is a thin API that connects workspaces, provisioners and users. coderd stores its state in Postgres and is the only service that communicates with Postgres.
 // @termsOfService https://coder.com/legal/terms-of-service
 
 // @contact.name API Support
@@ -122,9 +122,6 @@ type Options struct {
 
 // @license.name AGPL-3.0
 // @license.url https://github.com/coder/coder/blob/main/LICENSE
-
-// @host dev.coder.com
-// @BasePath /v2
 // New constructs a Coder API handler.
 func New(options *Options) *API {
 	if options == nil {
