improve OpenAPI response #11415

It looks like this now:

/info/applicationTermsOfUse:
  get:
    tags:
    - info
    operationId: Info_getApplicationTermsOfUse
    parameters:
    - name: lang
      in: query
      description: Two-character language code.
      required: false
      schema:
        type: string
      example: en
    responses:
      "200":
        description: Application Terms of Use (General Terms of Use) that must be
          agreed to at signup.

Author: pdurbin

src/main/java/edu/harvard/iq/dataverse/api/Info.java

@@ -30,6 +30,9 @@
 import jakarta.ws.rs.core.MediaType;
 import jakarta.ws.rs.core.Response;
 import org.eclipse.microprofile.openapi.annotations.Operation;
+import org.eclipse.microprofile.openapi.annotations.enums.SchemaType;
+import org.eclipse.microprofile.openapi.annotations.media.Schema;
+import org.eclipse.microprofile.openapi.annotations.parameters.Parameter;
 import org.eclipse.microprofile.openapi.annotations.responses.APIResponse;
 import org.eclipse.microprofile.openapi.annotations.tags.Tag;
 
@@ -80,7 +83,14 @@ public Response getServer() {
 
     @GET
     @Path("applicationTermsOfUse")
-    public Response getApplicationTermsOfUse(@QueryParam("lang") String lang) {
+    @APIResponse(responseCode = "200",
+                 description = "Application Terms of Use (General Terms of Use) that must be agreed to at signup.")
+    public Response getApplicationTermsOfUse(
+            @Parameter(description = "Two-character language code.",
+                    required = false,
+                    example = "en",
+                    schema = @Schema(type = SchemaType.STRING))
+            @QueryParam("lang") String lang) {
         return ok(systemConfig.getApplicationTermsOfUse(lang));
     }