Improve GraphQL documentation and cleanup API

Signed-off-by: Thomas Citharel <tcit@tcit.fr>

lib/graphql/schema/picture.ex

@@ -19,23 +19,23 @@ defmodule Mobilizon.GraphQL.Schema.PictureType do
   @desc "An attached picture or a link to a picture"
   input_object :picture_input do
     # Either a full picture object
-    field(:picture, :picture_input_object)
+    field(:picture, :picture_input_object, description: "A full picture attached")
     # Or directly the ID of an existing picture
-    field(:picture_id, :id)
+    field(:picture_id, :id, description: "The ID of an existing picture")
   end
 
   @desc "An attached picture"
   input_object :picture_input_object do
-    field(:name, non_null(:string))
-    field(:alt, :string)
-    field(:file, non_null(:upload))
-    field(:actor_id, :id)
+    field(:name, non_null(:string), description: "The picture's name")
+    field(:alt, :string, description: "The picture's alternative text")
+    field(:file, non_null(:upload), description: "The picture file")
+    field(:actor_id, :id, description: "The picture owner")
   end
 
   object :picture_queries do
     @desc "Get a picture"
     field :picture, :picture do
-      arg(:id, non_null(:string))
+      arg(:id, non_null(:string), description: "The picture ID")
       resolve(&Picture.picture/3)
     end
   end
@@ -43,10 +43,9 @@ defmodule Mobilizon.GraphQL.Schema.PictureType do
   object :picture_mutations do
     @desc "Upload a picture"
     field :upload_picture, :picture do
-      arg(:name, non_null(:string))
-      arg(:alt, :string)
-      arg(:file, non_null(:upload))
-      arg(:actor_id, non_null(:id))
+      arg(:name, non_null(:string), description: "The picture's name")
+      arg(:alt, :string, description: "The picture's alternative text")
+      arg(:file, non_null(:upload), description: "The picture file")
       resolve(&Picture.upload_picture/3)
     end
   end