Consistent comment style for :ex_aws
[akkoma] / lib / pleroma / web / api_spec / schemas / list.ex
index f85fac2b854df866aa4900bed25caa4f53254661..b7d1685c9281445a5ce943ef5211c95a234efb5f 100644 (file)
@@ -9,15 +9,15 @@ defmodule Pleroma.Web.ApiSpec.Schemas.List do
 
   OpenApiSpex.schema(%{
     title: "List",
-    description: "Response schema for a list",
+    description: "Represents a list of users",
     type: :object,
     properties: %{
-      id: %Schema{type: :string},
-      title: %Schema{type: :string}
+      id: %Schema{type: :string, description: "The internal database ID of the list"},
+      title: %Schema{type: :string, description: "The user-defined title of the list"}
     },
     example: %{
-      "id" => "123",
-      "title" => "my list"
+      "id" => "12249",
+      "title" => "Friends"
     }
   })
 end