More fixes

coder · mtojek · Dec 22, 2022 · Dec 20, 2022 · Dec 20, 2022 · Dec 20, 2022
commit ef213acae97fc23e88b9ffe91d416172335d185f
diff --git a/coderd/apidoc/docs.go b/coderd/apidoc/docs.go
@@ -744,7 +744,7 @@ const docTemplate = `{
                     ]
                 },
                 "object": {
-                    "description": "Object can represent a \"set\" of objects, such as:\n- All workspaces in an organization\n- All workspaces owned by me\n- All workspaces across the entire product\nWhen defining an object, use the most specific language when possible to\nproduce the smallest set. Meaning to set as many fields on 'Object' as\nyou can. Example, if you want to check if you can update all workspaces\nowned by 'me', try to also add an 'OrganizationID' to the settings.\nOmitting the 'OrganizationID' could produce the incorrect value, as\nworkspaces have both ` + "`" + `user` + "`" + ` and ` + "`" + `organization` + "`" + ` owners.",
+                    "description": "Object can represent a \"set\" of objects, such as:\n\t- All workspaces in an organization\n\t- All workspaces owned by me\n\t- All workspaces across the entire product\nWhen defining an object, use the most specific language when possible to\nproduce the smallest set. Meaning to set as many fields on 'Object' as\nyou can. Example, if you want to check if you can update all workspaces\nowned by 'me', try to also add an 'OrganizationID' to the settings.\nOmitting the 'OrganizationID' could produce the incorrect value, as\nworkspaces have both ` + "`" + `user` + "`" + ` and ` + "`" + `organization` + "`" + ` owners.",
                     "$ref": "#/definitions/codersdk.AuthorizationObject"
                 }
             }

diff --git a/coderd/apidoc/swagger.json b/coderd/apidoc/swagger.json
@@ -648,7 +648,7 @@
           "enum": ["create", "read", "update", "delete"]
         },
         "object": {
-          "description": "Object can represent a \"set\" of objects, such as:\n- All workspaces in an organization\n- All workspaces owned by me\n- All workspaces across the entire product\nWhen defining an object, use the most specific language when possible to\nproduce the smallest set. Meaning to set as many fields on 'Object' as\nyou can. Example, if you want to check if you can update all workspaces\nowned by 'me', try to also add an 'OrganizationID' to the settings.\nOmitting the 'OrganizationID' could produce the incorrect value, as\nworkspaces have both `user` and `organization` owners.",
+          "description": "Object can represent a \"set\" of objects, such as:\n\t- All workspaces in an organization\n\t- All workspaces owned by me\n\t- All workspaces across the entire product\nWhen defining an object, use the most specific language when possible to\nproduce the smallest set. Meaning to set as many fields on 'Object' as\nyou can. Example, if you want to check if you can update all workspaces\nowned by 'me', try to also add an 'OrganizationID' to the settings.\nOmitting the 'OrganizationID' could produce the incorrect value, as\nworkspaces have both `user` and `organization` owners.",
           "$ref": "#/definitions/codersdk.AuthorizationObject"
         }
       }

diff --git a/codersdk/authorization.go b/codersdk/authorization.go
@@ -25,9 +25,9 @@ type AuthorizationRequest struct {
 // @Description AuthorizationCheck is used to check if the currently authenticated user (or the specified user) can do a given action to a given set of objects.
 type AuthorizationCheck struct {
 	// Object can represent a "set" of objects, such as:
-	// - All workspaces in an organization
-	// - All workspaces owned by me
-	// - All workspaces across the entire product
+	//	- All workspaces in an organization
+	//	- All workspaces owned by me
+	//	- All workspaces across the entire product
 	// When defining an object, use the most specific language when possible to
 	// produce the smallest set. Meaning to set as many fields on 'Object' as
 	// you can. Example, if you want to check if you can update all workspaces

diff --git a/docs/api/applications.md b/docs/api/applications.md
@@ -22,9 +22,9 @@ curl -X GET http://coder-server:8080/api/v2/applications/auth-redirect \
 
 ### Responses
 
-| Status | Meaning                                                                 | Description        | Schema    |
-| ------ | ----------------------------------------------------------------------- | ------------------ | --------- |
-| 307    | [Temporary Redirect](https://tools.ietf.org/html/rfc7231#section-6.4.7) | Temporary Redirect | no schema |
+| Status | Meaning                                                                 | Description        | Schema |
+| ------ | ----------------------------------------------------------------------- | ------------------ | ------ |
+| 307    | [Temporary Redirect](https://tools.ietf.org/html/rfc7231#section-6.4.7) | Temporary Redirect |        |
 
 To perform this operation, you must be authenticated by means of one of the following methods: **CoderSessionToken**.
 

diff --git a/docs/api/workspaces.md b/docs/api/workspaces.md
@@ -707,9 +707,9 @@ curl -X PATCH http://coder-server:8080/api/v2/workspaces/{workspace} \
 
 ### Responses
 
-| Status | Meaning                                                         | Description | Schema    |
-| ------ | --------------------------------------------------------------- | ----------- | --------- |
-| 204    | [No Content](https://tools.ietf.org/html/rfc7231#section-6.3.5) | No Content  | no schema |
+| Status | Meaning                                                         | Description | Schema |
+| ------ | --------------------------------------------------------------- | ----------- | ------ |
+| 204    | [No Content](https://tools.ietf.org/html/rfc7231#section-6.3.5) | No Content  |        |
 
 To perform this operation, you must be authenticated by means of one of the following methods: **CoderSessionToken**.
 
@@ -743,9 +743,9 @@ curl -X PUT http://coder-server:8080/api/v2/workspaces/{workspace}/autostart \
 
 ### Responses
 
-| Status | Meaning                                                         | Description | Schema    |
-| ------ | --------------------------------------------------------------- | ----------- | --------- |
-| 204    | [No Content](https://tools.ietf.org/html/rfc7231#section-6.3.5) | No Content  | no schema |
+| Status | Meaning                                                         | Description | Schema |
+| ------ | --------------------------------------------------------------- | ----------- | ------ |
+| 204    | [No Content](https://tools.ietf.org/html/rfc7231#section-6.3.5) | No Content  |        |
 
 To perform this operation, you must be authenticated by means of one of the following methods: **CoderSessionToken**.
 
@@ -833,9 +833,9 @@ curl -X PUT http://coder-server:8080/api/v2/workspaces/{workspace}/ttl \
 
 ### Responses
 
-| Status | Meaning                                                         | Description | Schema    |
-| ------ | --------------------------------------------------------------- | ----------- | --------- |
-| 204    | [No Content](https://tools.ietf.org/html/rfc7231#section-6.3.5) | No Content  | no schema |
+| Status | Meaning                                                         | Description | Schema |
+| ------ | --------------------------------------------------------------- | ----------- | ------ |
+| 204    | [No Content](https://tools.ietf.org/html/rfc7231#section-6.3.5) | No Content  |        |
 
 To perform this operation, you must be authenticated by means of one of the following methods: **CoderSessionToken**.
 

diff --git a/scripts/apidocgen/markdown-template/responses.def b/scripts/apidocgen/markdown-template/responses.def
@@ -6,7 +6,7 @@
 			break;
 		}
 		if (!content) {
-			return "no schema";
+			return "";
 		}
 
 		var ref = content.schema["x-widdershins-oldRef"];